From dd12247222bd2290494f90c77489432bc12cafce Mon Sep 17 00:00:00 2001
From: Alexa <alexa.kristensen@docker.com>
Date: Wed, 21 Oct 2026 08:42:50 -0500
Subject: [PATCH 1/5] docs: document self-serve plan billing actions

Add the billing actions customers can take from Docker Home that the plan pages left out.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../manuals/subscription-billing/plans/dhi.md |  2 ++
 .../plans/docker-agentic-platform.md          | 14 ++++++++++
 .../plans/docker-verified-publisher.md        | 26 ++++++++++++++++++-
 .../subscription-billing/plans/docker.md      | 16 ++++++++++++
 .../subscription-billing/plans/gordon.md      | 17 +++++++++++-
 5 files changed, 73 insertions(+), 2 deletions(-)

diff --git a/content/manuals/subscription-billing/plans/dhi.md b/content/manuals/subscription-billing/plans/dhi.md
index 862e8ad16ab5..a1309752c1c5 100644
--- a/content/manuals/subscription-billing/plans/dhi.md
+++ b/content/manuals/subscription-billing/plans/dhi.md
@@ -49,6 +49,8 @@ If you want to revert your plan to DHI Community, you must disable auto-renewal.
 1. From **Active plans**, select **Manage** next to **Hardened Images**.
 1. Select **Disable auto-renewal**.
 
+If you disabled auto-renewal and the plan is still active, **Manage** includes **Enable auto-renewal**.
+
 ## Remove repositories
 
 You may also remove repositories from your plan. Repository removals are deferred to the end of the current billing cycle. You can remove repositories at any time, but you cannot stop a plan mid-cycle to receive a partial refund. Repository access remains active until the cycle ends.
diff --git a/content/manuals/subscription-billing/plans/docker-agentic-platform.md b/content/manuals/subscription-billing/plans/docker-agentic-platform.md
index b8ec6f3f86df..c9b5e929ce53 100644
--- a/content/manuals/subscription-billing/plans/docker-agentic-platform.md
+++ b/content/manuals/subscription-billing/plans/docker-agentic-platform.md
@@ -65,6 +65,8 @@ For example:
 - Your invoice can take up to 24 hours after your billing date to
   appear.
 
+Credits are applied to your costs at the end of the billing period.
+
 ## Cancel a plan
 
 Canceling Docker Agentic Platform disables subscription renewal at the
@@ -78,6 +80,18 @@ the plan period.
 1. Select **Cancel subscription**.
 1. Review your usage, then select **Cancel subscription** to confirm.
 
+## Re-enable renewal
+
+After you cancel, you can re-enable renewal at any time before the
+current period ends. Your subscription then continues past the renewal
+date.
+
+1. Sign in to [Docker Home](https://app.docker.com/) and go to
+   **Billing**.
+1. From **Active subscriptions**, select **Manage** next to
+   **Docker Agentic Platform**.
+1. Select **Re-enable renewal**.
+
 ## Next steps
 
 - To add or cancel a plan, see
diff --git a/content/manuals/subscription-billing/plans/docker-verified-publisher.md b/content/manuals/subscription-billing/plans/docker-verified-publisher.md
index f71b5aa76b94..2724f88fd9f5 100644
--- a/content/manuals/subscription-billing/plans/docker-verified-publisher.md
+++ b/content/manuals/subscription-billing/plans/docker-verified-publisher.md
@@ -88,7 +88,9 @@ portal:
 
 DVP Starter and DVP Growth are billed annually. You can upgrade from
 DVP Starter to DVP Growth without a new application. Upgrades take
-effect immediately.
+effect immediately. Downgrades take effect at the end of the annual
+period. For steps, see
+[Upgrade or downgrade](#upgrade-or-downgrade).
 
 On DVP Growth, consuming domain add-ons are prorated from the purchase
 date through the rest of your billing period, and they expire at the
@@ -99,6 +101,25 @@ any time. Removals take effect at the end of the current billing cycle.
 > No mid-cycle refunds are issued when you reduce consuming domain
 > add-ons or end a DVP plan.
 
+## Upgrade or downgrade
+
+You can move between DVP Starter and DVP Growth from the billing portal.
+
+1. Sign in to [Docker Home](https://app.docker.com/) and go to
+   **Billing**.
+1. From **Active plans**, select **Manage** next to **Docker Verified
+   Publisher**.
+1. Choose the change you want:
+   - To upgrade, select **Upgrade to Growth**, then verify your billing
+     details, continue to payment, and complete checkout. The upgrade
+     takes effect immediately.
+   - To downgrade, select **Downgrade to Starter**. The downgrade is
+     scheduled for the end of the annual period, and you keep DVP Growth
+     until then.
+
+If a downgrade is scheduled and you change your mind, select **Manage**,
+then **Cancel scheduled downgrade** to keep DVP Growth after renewal.
+
 ## Disable auto-renewal
 
 To end a DVP plan, disable automatic renewal. Your plan stays active
@@ -112,3 +133,6 @@ auto-renewal:
 1. Select **Disable auto-renewal**.
 1. Optional. To remove consuming domains, select **Remove consuming
    domains**, then choose the number to remove.
+
+If you disabled auto-renewal and the plan is still active, **Manage**
+includes **Enable auto-renewal**.
diff --git a/content/manuals/subscription-billing/plans/docker.md b/content/manuals/subscription-billing/plans/docker.md
index 9b5b03dbe13d..0352fc08d182 100644
--- a/content/manuals/subscription-billing/plans/docker.md
+++ b/content/manuals/subscription-billing/plans/docker.md
@@ -56,6 +56,19 @@ Docker plans are billed at a flat rate per user per month, with monthly or
 annual billing options. Upgrading your plan immediately extends access to
 all features and entitlements.
 
+### Switch to annual billing
+
+When you manage the subscription yourself and the plan is billed monthly,
+the action menu includes **Switch to annual billing**. The review shows the
+annual total and a **Prorated credit** for the unused part of the current
+monthly period. The amount due today is labeled **Prorated for this year**.
+
+1. Sign in to [Docker Home](https://app.docker.com/) and go to **Billing**.
+1. From **Active subscriptions**, select the action menu next to your Docker
+   plan.
+1. Select **Switch to annual billing**.
+1. Review the annual total and prorated credit, then complete checkout.
+
 ### Organization seats
 
 For Docker Team and Docker Business, each seat extends your paid plan to one
@@ -156,6 +169,9 @@ organization account. To cancel your plan:
    plan.
 1. Select **Cancel plan** and complete the feedback survey.
 
+If you cancel and the plan is still in its current billing cycle, the action
+menu includes **Reactivate**.
+
 ## Next steps
 
 - To add or upgrade a plan, see
diff --git a/content/manuals/subscription-billing/plans/gordon.md b/content/manuals/subscription-billing/plans/gordon.md
index 2e43c7ee2b04..457ec7cb3e45 100644
--- a/content/manuals/subscription-billing/plans/gordon.md
+++ b/content/manuals/subscription-billing/plans/gordon.md
@@ -34,7 +34,18 @@ Gordon usage is measured in questions. When you upgrade from Gordon Base to a pa
 
 ## Billing cycle
 
-Gordon plans are billed monthly at the first of the month. If you purchase after the first of the month, your invoice reflects prorated charges for the remaining days in the cycle. Subscribing to a Gordon plan charges you at the time of purchase. When you upgrade your Gordon plan, usage limits are immediately effective after payment. 
+Gordon plans are billed monthly at the first of the month. If you purchase after the first of the month, your invoice reflects prorated charges for the remaining days in the cycle. Subscribing to a Gordon plan charges you at the time of purchase. When you upgrade your Gordon plan, usage limits are immediately effective after payment.
+
+## Upgrade
+
+You can move to a higher Gordon tier at any time. The new usage limits
+take effect after payment.
+
+1. Sign in to [Docker Home](https://app.docker.com/) and go to **Billing**.
+1. From **Active plans**, select **Manage** next to your Gordon plan.
+1. Select **Upgrade subscription**.
+1. Choose the tier, verify your billing details, continue to payment, and
+   complete checkout.
 
 ## Downgrade or disable auto-renewal
 
@@ -49,6 +60,10 @@ To downgrade or disable auto-renewal:
 1. From **Active plans**, select **Manage** next to your Gordon plan.
 1. Select **Downgrade plan** to switch to a lower tier, or **Disable auto renewal** to end your plan after the current billing cycle.
 
+If you disabled auto-renewal and the plan is still active, **Manage** includes **Enable auto-renewal**.
+
+If a downgrade is scheduled, **Manage** includes **Cancel scheduled change**. Selecting it keeps your current tier after renewal.
+
 > [!IMPORTANT]
 > Docker does not issue refunds or credits
 > for remaining days in the current cycle.

From 046a75942158aea0b348a90dc2ec4177a66b9f42 Mon Sep 17 00:00:00 2001
From: Alexa <alexa.kristensen@docker.com>
Date: Wed, 21 Oct 2026 14:41:17 -0500
Subject: [PATCH 2/5] docs: explain what each Billing page shows

The manage page repeated steps covered on the other billing pages and never said what each Billing screen shows.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../subscription-billing/manage/_index.md     | 104 ++++++++++++------
 1 file changed, 70 insertions(+), 34 deletions(-)

diff --git a/content/manuals/subscription-billing/manage/_index.md b/content/manuals/subscription-billing/manage/_index.md
index a1cfcb561e5b..f9c7008462c5 100644
--- a/content/manuals/subscription-billing/manage/_index.md
+++ b/content/manuals/subscription-billing/manage/_index.md
@@ -1,8 +1,12 @@
 ---
 title: Manage billing
 linkTitle: Manage
-description: Manage Docker plans, payment methods, billing details, invoices, and taxes.
-keywords: manage plans, billing, payment methods, invoices, taxes, docker subscription
+description: >-
+  Review Billing in Docker Home: plans, payment methods, invoices, usage,
+  costs, credits, and billing details, and what you can do on each page.
+keywords: billing, docker home, billing overview, manage plans, payment
+  methods, invoices, usage, costs, credits, billing settings, subscription
+  totals, taxes, docker subscription
 weight: 20
 grid:
   - title: Manage plans
@@ -10,19 +14,24 @@ grid:
     icon: shopping-cart
     link: /subscription-billing/manage/plans/
   - title: Add or update a payment method
-    description: Add or update a payment method for your individual account or organization.
+    description: >-
+      Add or update a payment method for your individual account or
+      organization.
     icon: credit-card
     link: /subscription-billing/manage/payment-method/
   - title: Update billing information
-    description: Update billing information for your individual account or organization.
+    description: >-
+      Update billing information for your individual account or
+      organization.
     icon: pencil-square
     link: /subscription-billing/manage/details/
-  - title: View billing history
+  - title: Invoices
     description: View billing history and download past invoices.
-    icon: credit-card
+    icon: receipt-percent
     link: /subscription-billing/manage/history/
   - title: 3D Secure authentication
-    description: Learn how 3DS works and how to troubleshoot verification issues.
+    description: >-
+      Learn how 3DS works and how to troubleshoot verification issues.
     icon: wallet
     link: /subscription-billing/manage/3d-secure/
   - title: Taxes
@@ -31,49 +40,76 @@ grid:
     link: /subscription-billing/manage/tax-certificate/
 ---
 
-You manage Docker plans, payment methods, invoices, credits, and taxes from
-Docker Home. Billing is scoped to the account you
-select. To manage billing:
-
-1. Sign in to [Docker Home](https://app.docker.com/), then choose your
-   individual account or organization.
-1. Select **Billing**.
-1. Select the page you want in the sidebar, or stay on **Overview**.
+You manage Docker plans, payment methods, invoices, usage, costs, credits, and
+billing details from **Billing** in Docker Home. Billing applies to the
+account you select, either your individual account or an organization.
 
-To add or upgrade a plan, see
-[Manage plans](/manuals/subscription-billing/manage/plans.md). To compare
-plan types, see [Plans](/manuals/subscription-billing/plans/_index.md).
+For an organization, you must be an organization owner, or have a
+[custom role](/manuals/security/roles-and-permissions/custom-roles/permissions-reference.md#billing)
+with the **View billing** or **Manage billing** permission. Without it, Docker
+Home shows **No access to billing**.
 
 ## Overview
 
-When you select **Billing**, you are taken to the **Overview** page, where you review active plans, payment
-method, and subscription totals for that account. From there you add
-self-serve products, manage a plan you already have, or open another
-billing page in the sidebar.
+**Overview** is the Billing home. It shows the default payment method, a tile
+for each active plan, and your subscription totals with the next charge date.
+The page also shows:
+
+* **Monthly subscriptions** when you have a monthly plan
+* **Annual subscriptions** when you have an annual plan
+* An alert for a
+  [failed payment](/manuals/subscription-billing/manage/payment-method.md#failed-payments)
+  or a
+  [bank account waiting for verification](/manuals/subscription-billing/manage/payment-method.md#verify-a-bank-account)
+
+> [!TIP]
+>
+> If Docker sales manages your subscription, the sidebar shows **Overview**
+> only. Contact your Docker sales representative to renew, make changes, or
+> request invoices.
 
 ## Invoices
 
-The billing **Invoices** page lists invoices issued when a plan renews or
-changes. You can open an invoice, check payment status, and download a
-copy. 
+**Invoices** lists every invoice with its date, number, description, status,
+and amount. You can open an invoice or download a PDF when your Docker account
+has a verified email address.
 
 ## Usage
 
-The billing **Usage** page helps you compare usage-based charges across
-billing periods. You can track usage by changing the period, product,
-and how the product is metered.
+**Usage** charts usage-based charges across billing periods. You can filter
+by period, product, and meter, and export a CSV.
+
+Plans that report usage appear here, including Docker Build Cloud minutes,
+Testcontainers Cloud minutes, and Docker Agentic Platform compute. With no
+usage-based plan, the page shows **No usage-based products**. See
+[Plans](/manuals/subscription-billing/plans/_index.md#choose-a-plan)
+for which plans are metered.
 
 ## Costs
 
-The billing **Costs** page aggregates all costs by billing period. It
-breaks down charges by resource (the product accruing a charge), the
-status of your billing period, and costs to date.
+**Costs** shows charges for one billing period, grouped by the product each
+charge is for. The page labels that column **Resource**. You can switch
+billing periods and export a CSV. Costs also shows:
+
+* Period status
+* Amounts excluding tax
+* **Cost to date** for the current period
+* The subtotal for a closed period
+* Credits, when the account has them
+
+An invoice total can differ, because the invoice adds tax and any credits.
 
 ## Credits
 
-The billing **Credits** page shows credits applied to your costs. If you
-received a promotional credit, you can see how it applies to your bill
-from this page.
+**Credits** shows the credit balances for your products. Open a balance to
+see each grant and its remaining amount. Docker applies these balances to
+your costs at the end of the billing period.
+
+## Settings
+
+**Settings** shows the default payment method, billing address, tax ID, and
+billing email. You can update the payment method, address, or billing email
+on this page.
 
 ## Next steps
 

From 951b311e195cbdb4543ff1ea206f39b9ad4148d5 Mon Sep 17 00:00:00 2001
From: Alexa <alexa.kristensen@docker.com>
Date: Wed, 21 Oct 2026 14:41:47 -0500
Subject: [PATCH 3/5] updates

---
 .../manuals/subscription-billing/_index.md    | 99 +++++++++----------
 .../subscription-billing/manage/plans.md      | 47 +++------
 .../subscription-billing/plans/_index.md      | 48 ++++++---
 .../manuals/subscription-billing/plans/dhi.md | 13 ++-
 .../plans/docker-agentic-platform.md          |  2 +-
 .../subscription-billing/plans/gordon.md      |  2 +-
 6 files changed, 113 insertions(+), 98 deletions(-)

diff --git a/content/manuals/subscription-billing/_index.md b/content/manuals/subscription-billing/_index.md
index 01d1a1228fc0..ef0991f9f339 100644
--- a/content/manuals/subscription-billing/_index.md
+++ b/content/manuals/subscription-billing/_index.md
@@ -1,9 +1,13 @@
 ---
-title: Subscription and billing
+title: Docker subscriptions and billing
 linkTitle: Subscription and billing
-description: Manage Docker subscriptions, plans, billing, and payments.
+description: >-
+  Learn about Docker subscription plans, billing models, payment methods,
+  invoices, usage, credits, taxes, and how to manage plan changes in Docker
+  Home.
 keywords:
-  subscription, billing, docker plans, payments, invoices, pricing, top up,
+  docker subscription, docker billing, docker plans, billing models, pricing,
+  payment methods, invoices, usage, credits, taxes, auto-renewal, plan upgrades,
   add-ons, seats, licenses, minutes
 weight: 20
 params:
@@ -16,66 +20,57 @@ aliases:
   - /docker-hub/billing/faq/
   - /billing/docker-hub-pricing/
 grid:
-  - title: Explore plans
+  - title: Plans
     description: >-
-      Browse available Docker plans and add-ons for individuals, teams, and
-      organizations.
+      Compare billing models and tiers for Docker, Docker Hardened Images,
+      Gordon, Docker Agentic Platform, AI Governance, and DVP.
     link: /subscription-billing/plans/
     icon: chart-bar
-  - title: Manage billing
+  - title: Manage plans
     description: >-
-      Manage payment methods, invoices, credits, and billing details in the
-      billing portal.
+      Subscribe to a new plan, upgrade an active plan, or cancel auto-renewal.
+    link: /subscription-billing/manage/plans/
+    icon: shopping-cart
+  - title: Billing overview
+    description: >-
+      Open Billing in Docker Home to review active plans, usage, costs, and
+      credits for an account.
     link: /subscription-billing/manage/
     icon: credit-card
+  - title: Payment methods
+    description: >-
+      Add or update a card, US bank account, or Stripe Link, or set up pay by
+      invoice for annual organization plans.
+    link: /subscription-billing/manage/payment-method/
+    icon: banknotes
+  - title: Invoices
+    description: View billing history and download past invoices.
+    link: /subscription-billing/manage/history/
+    icon: receipt-percent
+  - title: 3D Secure authentication
+    description: Learn how 3DS works and how to troubleshoot card verification.
+    link: /subscription-billing/manage/3d-secure/
+    icon: shield-check
 ---
 
-A Docker plan is a subscription tied to an individual account, an organization
-account, or a specific product. When you upgrade a plan, you expand your
-usage entitlements and feature sets. You can also top up some plans,
-extending usage without changing your plan type.
-
-## Docker plans
-
-The following table summarizes the available plans.
-
-| Plans | Billing model | Types |
-| --- | --- | --- |
-| [Docker](/manuals/subscription-billing/plans/docker.md) | Flat-rate plans for personal and organization accounts | Docker Personal, Docker Pro, Docker Team, Docker Business |
-| [Docker Hardened Images (DHI)](/manuals/subscription-billing/plans/dhi.md) | Annual plans billed per repository. DHI Community is free. | DHI Community, DHI Select, DHI Enterprise |
-| [Gordon](/manuals/subscription-billing/plans/gordon.md) | Monthly plans that raise your Gordon usage allowance | Gordon Plus, Gordon Max, Gordon Ultra |
-| [Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md) | Pay-as-you-go cloud compute, billed monthly | Pay-as-you-go |
-| [AI Governance](/manuals/subscription-billing/plans/ai-governance.md) | Licenses purchased through Docker sales. <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_index_aigov" class="link" rel="noopener">Contact sales</a> to add more. | AI Governance |
-| [Docker Verified Publisher (DVP)](/manuals/subscription-billing/plans/docker-verified-publisher.md) | Flat-rate annual plans. DVP Growth lets you add consuming domains in blocks of 25. | DVP Starter, DVP Growth |
-
-Docker plans that upgrade your account (Docker Pro, Team, and Business) cover
-most use cases. Some product plans require an upgraded Docker account. Others
-let you subscribe without one. For details, see
-[Plans](/manuals/subscription-billing/plans/_index.md).
-
-## Top up your plan
-
-Plans come with usage entitlements that can be extended without upgrading to
-a different plan.
-
-| Unit | Description | Examples |
-| --- | --- | --- |
-| [Seats](/manuals/accounts/organization/manage/manage-seats.md) | Each seat extends entitlements to one more member. | Docker Team, Docker Business |
-| [Licenses](/manuals/accounts/organization/manage/manage-licenses.md) | Access to specific products or features. | AI Governance, Docker Offload |
-| [Minutes](/manuals/subscription-billing/plans/docker.md#docker-build-cloud-minutes) | Build and test runtime capacity, sold in blocks and consumed within the billing period. | Docker Build Cloud, [Testcontainers Cloud](/manuals/subscription-billing/plans/docker.md#testcontainers-cloud-minutes) |
-| [Repositories](/manuals/subscription-billing/plans/dhi.md) | Additional container repositories covered by security scanning and analysis features. | DHI |
-| [Consuming domains](/manuals/subscription-billing/plans/docker-verified-publisher.md#add-consuming-domains) | Additional consuming domains tracked in publisher analytics, sold in blocks of 25. | DVP Growth |
+> [!TIP]
+>
+> Compare plan features and prices on the
+> <a href="https://www.docker.com/pricing/" id="dkr_docs_index_pricing" class="link" rel="noopener">Docker pricing page</a>.
 
-## Manage your plans
+Docker subscriptions determine the products, features, and usage included with
+an individual account or organization. This section explains the available
+plans and how to manage subscriptions and billing.
 
-To subscribe to a new plan or upgrade an active plan, see
-[Manage plans](/manuals/subscription-billing/manage/plans.md). See
-[Docker plans](/manuals/subscription-billing/plans/docker.md) to learn about
-Docker Team, Business, and Pro. You can also
-<a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_index_sales" class="link" rel="noopener">contact sales</a>.
+Use these docs to:
 
-To update payment methods, review usage and credits, or download invoices, see
-[Manage billing](/manuals/subscription-billing/manage/_index.md).
+- Compare Docker account plans and product-specific plans, including their
+  billing models, usage entitlements, and available add-ons. You can also
+  review Docker Desktop licensing requirements.
+- Purchase a plan and manage an active subscription by upgrading, downgrading,
+  adding seats or usage, managing auto-renewal, or canceling the plan.
+- Manage payment methods and billing details, review invoices and taxes, and
+  track usage, costs, and credits for an account in Docker Home.
 
 ## Next steps
 
diff --git a/content/manuals/subscription-billing/manage/plans.md b/content/manuals/subscription-billing/manage/plans.md
index 8c4b3bf02aa7..c05aa3b25ef5 100644
--- a/content/manuals/subscription-billing/manage/plans.md
+++ b/content/manuals/subscription-billing/manage/plans.md
@@ -45,39 +45,24 @@ To upgrade to Docker Pro, go to the
 <a href="https://www.docker.com/pricing/" id="dkr_docs_pricing_manage_pro" class="link" rel="noopener">Docker pricing page</a>
 and select **Buy now**.
 
-## Upgrade plans
-
-You can upgrade active plans from the billing Overview page.
-
-1. Sign in to [Docker Home](https://app.docker.com/), then choose your personal
-   account or your organization account.
-1. Go to **Billing** to view the Overview page.
-   - The Overview page contains your active plans and payment details.
-   - **Active plans** contains information about plan type, renewal cadence, and usage.
-1. Top up or upgrade from the **Active plans** section.
-   - **Active plans** is where you complete all management actions.
-   - Depending on the plan type, you can select the action menu button or the **Manage** button to choose from available actions.
-1. Verify your billing details, continue to payment, and complete checkout.
-
-> [!TIP]
-> Billing cycle details vary from plan to plan. Learn more about usage, downgrading, or canceling plans
-> from the relevant
-> [product page](/manuals/subscription-billing/plans/_index.md).
-
-## View your credits
-
-Docker displays available account credits in the billing portal. Credits
-offset eligible usage automatically before Docker charges your payment
-method. To review credit balance and applied credits, see
+## Change an active plan {#upgrade-plans}
+
+These are the actions available on a plan you already have. Sign in to
+[Docker Home](https://app.docker.com/), go to **Billing**, then go to
+**Active subscriptions**. The control on the plan tile depends on the plan.
+Each plan page has the steps and says when the change takes effect.
+
+| Plan | Control | Actions |
+| --- | --- | --- |
+| [Docker](/manuals/subscription-billing/plans/docker.md) | Action menu | Add or remove seats, add Build Cloud or Testcontainers Cloud minutes, switch to annual billing, cancel, reactivate |
+| [Gordon](/manuals/subscription-billing/plans/gordon.md) | **Manage** | Upgrade, downgrade, disable or enable auto-renewal |
+| [Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md) | **Manage** | Cancel, re-enable renewal |
+| [Docker Hardened Images](/manuals/subscription-billing/plans/dhi.md) | **Manage** | Add or remove repositories, disable or enable auto-renewal |
+| [Docker Verified Publisher](/manuals/subscription-billing/plans/docker-verified-publisher.md) | **Manage** | Upgrade or downgrade, add or remove consuming domains, disable or enable auto-renewal |
+
+To review credits, see
 [Credits](/manuals/subscription-billing/manage/_index.md#credits).
 
-Credits apply to
-[Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md).
-When you sign up for Docker Agentic Platform, Docker adds a one-time
-promotional credit to your account. This credit is non-recurring,
-doesn't expire, and applies to cloud compute usage only. It doesn't
-apply to inference, which you pay for through your own API keys.
-
 ## Sales-led products
 
 Some products are sales-led. You must
diff --git a/content/manuals/subscription-billing/plans/_index.md b/content/manuals/subscription-billing/plans/_index.md
index bb347ef93fd7..5f667c2c3866 100644
--- a/content/manuals/subscription-billing/plans/_index.md
+++ b/content/manuals/subscription-billing/plans/_index.md
@@ -46,26 +46,50 @@ grid:
     icon: check-badge
 ---
 
-> [!TIP]
-> Interested in pricing details? Check out the
-> <a href="https://www.docker.com/pricing/" id="dkr_docs_index_pricing" class="link" rel="noopener">pricing page</a> to compare plans.
 
 Docker plans attach to an individual account, an organization, or a specific
-product. Docker Personal and Docker Pro are subscriptions for individual
-accounts. Docker Team and Docker Business are subscriptions for organization
-accounts. Product add-ons add usage or features without changing that
-account's Docker plan type: Gordon and Docker Agentic Platform attach to an
-individual account, and DHI, AI Governance, and DVP add product features on an
-organization.
+product. 
 
-Topping up extends a plan's entitlements, such as seats, licenses, or
-minutes, without changing the plan type. For the units you can top up, see
-[Top up your plan](/manuals/subscription-billing/_index.md#top-up-your-plan).
+* Docker Personal and Docker Pro are subscriptions for individual
+accounts. 
+* Docker Team and Docker Business are subscriptions for organization
+accounts. 
+* Product plans let you subscribe to a Docker product without altering 
+your account type plan. 
 
 Each plan page covers usage entitlements, billing cycle, and management
 options. To add or upgrade a plan, see
 [Manage plans](/manuals/subscription-billing/manage/plans.md).
 
+## Choose a plan
+
+Compare billing models and tiers before you subscribe.
+
+| Plans | Billing model | Types |
+| --- | --- | --- |
+| [Docker](/manuals/subscription-billing/plans/docker.md) | Flat-rate plans for personal and organization accounts | Docker Personal, Docker Pro, Docker Team, Docker Business |
+| [Docker Hardened Images (DHI)](/manuals/subscription-billing/plans/dhi.md) | Annual plans billed per repository. DHI Community is free. | DHI Community, DHI Select, DHI Enterprise |
+| [Gordon](/manuals/subscription-billing/plans/gordon.md) | Monthly plans that raise your Gordon usage allowance | Gordon Plus, Gordon Max, Gordon Ultra |
+| [Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md) | Pay-as-you-go cloud compute, billed monthly | Pay-as-you-go |
+| [AI Governance](/manuals/subscription-billing/plans/ai-governance.md) | Licenses purchased through Docker sales. <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_plans_index_aigov" class="link" rel="noopener">Contact sales</a> to add more. | AI Governance |
+| [Docker Verified Publisher (DVP)](/manuals/subscription-billing/plans/docker-verified-publisher.md) | Flat-rate annual plans. DVP Growth lets you add consuming domains in blocks of 25. | DVP Starter, DVP Growth |
+
+Docker plans that upgrade your account (Docker Pro, Team, and Business) cover
+most use cases. Some product plans require an upgraded Docker account while others
+let you subscribe without one.
+
+## Add units to a plan {#top-up-your-plan}
+
+Add seats, minutes, or other units without changing the plan type.
+
+| Unit | Description | Examples |
+| --- | --- | --- |
+| [Seats](/manuals/accounts/organization/manage/manage-seats.md) | Each seat extends entitlements to one more member. | Docker Team, Docker Business |
+| [Licenses](/manuals/accounts/organization/manage/manage-licenses.md) | Access to specific products or features. | AI Governance, Docker Offload |
+| [Minutes](/manuals/subscription-billing/plans/docker.md#docker-build-cloud-minutes) | Build and test runtime capacity, sold in blocks and consumed within the billing period. | Docker Build Cloud, [Testcontainers Cloud](/manuals/subscription-billing/plans/docker.md#testcontainers-cloud-minutes) |
+| [Repositories](/manuals/subscription-billing/plans/dhi.md) | Additional container repositories covered by security scanning and analysis features. | DHI |
+| [Consuming domains](/manuals/subscription-billing/plans/docker-verified-publisher.md#add-consuming-domains) | Additional consuming domains tracked in publisher analytics, sold in blocks of 25. | DVP Growth |
+
 ## Product catalog
 
 {{< grid >}}
diff --git a/content/manuals/subscription-billing/plans/dhi.md b/content/manuals/subscription-billing/plans/dhi.md
index a1309752c1c5..8cccd147fa67 100644
--- a/content/manuals/subscription-billing/plans/dhi.md
+++ b/content/manuals/subscription-billing/plans/dhi.md
@@ -39,7 +39,18 @@ For details on setting up and managing repositories, see [Get started with DHI S
 
 ## Billing cycle
 
-DHI Select is an annual plan billed per repository from the date your plan starts. Repositories added mid-cycle are prorated for the remainder of the billing period. You can add more repositories to your DHI Select plan by going to **Active plans** in the billing portal. For steps, see [Manage plans](/manuals/subscription-billing/manage/plans.md#upgrade-plans).
+DHI Select is an annual plan billed per repository from the date your plan starts. Repositories added mid-cycle are prorated for the remainder of the billing period. For steps, see [Add repositories](#add-repositories).
+
+## Add repositories
+
+Repositories you add take effect immediately and are prorated for the rest
+of the billing period.
+
+1. Sign in to [Docker Home](https://app.docker.com/) and go to **Billing**.
+1. From **Active plans**, select **Manage** next to **Hardened Images**.
+1. Select **Add repositories**.
+1. Choose the number of repositories, verify your billing details, continue
+   to payment, and complete checkout.
 
 ## Disable auto-renewal
 
diff --git a/content/manuals/subscription-billing/plans/docker-agentic-platform.md b/content/manuals/subscription-billing/plans/docker-agentic-platform.md
index c9b5e929ce53..e89373de23f7 100644
--- a/content/manuals/subscription-billing/plans/docker-agentic-platform.md
+++ b/content/manuals/subscription-billing/plans/docker-agentic-platform.md
@@ -94,7 +94,7 @@ date.
 
 ## Next steps
 
-- To add or cancel a plan, see
+- To add a plan, see
   [Manage plans](/manuals/subscription-billing/manage/plans.md)
 - To track usage across plans, see
   [Usage](/manuals/subscription-billing/manage/_index.md#usage)
diff --git a/content/manuals/subscription-billing/plans/gordon.md b/content/manuals/subscription-billing/plans/gordon.md
index 457ec7cb3e45..0470a2ae610c 100644
--- a/content/manuals/subscription-billing/plans/gordon.md
+++ b/content/manuals/subscription-billing/plans/gordon.md
@@ -21,7 +21,7 @@ aliases:
 - Gordon Max is for power users who rely on Gordon throughout their workflow. It offers a significantly higher usage allowance than Plus.
 - Gordon Ultra is for developers with the highest usage needs. It provides the maximum monthly allowance available on a self-serve plan.
 
-To upgrade to a Gordon paid plan, see [Manage plans](/manuals/subscription-billing/manage/plans.md).
+To subscribe to a Gordon paid plan, see [Manage plans](/manuals/subscription-billing/manage/plans.md). To move between paid tiers, see [Upgrade](#upgrade).
 
 ## Usage
 

From 6d8a8658f79f91df7532a021b9ecd9f8d6774b89 Mon Sep 17 00:00:00 2001
From: Alexa <alexa.kristensen@docker.com>
Date: Thu, 22 Oct 2026 08:56:48 -0500
Subject: [PATCH 4/5] docs: simplify plan change and catalog pages

The upgrade section repeated each plan's actions, and the catalog mixed setup notes into the plan list.

Summarize how to change a plan, link to the catalog, and move the AI Governance and DVP tips to the top of each page.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../subscription-billing/manage/plans.md      | 21 ++++++---------
 .../subscription-billing/plans/_index.md      | 26 +++++++------------
 .../plans/ai-governance.md                    |  4 +--
 .../plans/docker-verified-publisher.md        |  8 +++---
 4 files changed, 24 insertions(+), 35 deletions(-)

diff --git a/content/manuals/subscription-billing/manage/plans.md b/content/manuals/subscription-billing/manage/plans.md
index c05aa3b25ef5..b35fe0ef2f7f 100644
--- a/content/manuals/subscription-billing/manage/plans.md
+++ b/content/manuals/subscription-billing/manage/plans.md
@@ -47,21 +47,16 @@ and select **Buy now**.
 
 ## Change an active plan {#upgrade-plans}
 
-These are the actions available on a plan you already have. Sign in to
+To change a plan you already have, sign in to
 [Docker Home](https://app.docker.com/), go to **Billing**, then go to
-**Active subscriptions**. The control on the plan tile depends on the plan.
-Each plan page has the steps and says when the change takes effect.
+**Active subscriptions**. Each plan tile has a control, such as an action
+menu or a **Manage** button, that opens the options for that plan.
 
-| Plan | Control | Actions |
-| --- | --- | --- |
-| [Docker](/manuals/subscription-billing/plans/docker.md) | Action menu | Add or remove seats, add Build Cloud or Testcontainers Cloud minutes, switch to annual billing, cancel, reactivate |
-| [Gordon](/manuals/subscription-billing/plans/gordon.md) | **Manage** | Upgrade, downgrade, disable or enable auto-renewal |
-| [Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md) | **Manage** | Cancel, re-enable renewal |
-| [Docker Hardened Images](/manuals/subscription-billing/plans/dhi.md) | **Manage** | Add or remove repositories, disable or enable auto-renewal |
-| [Docker Verified Publisher](/manuals/subscription-billing/plans/docker-verified-publisher.md) | **Manage** | Upgrade or downgrade, add or remove consuming domains, disable or enable auto-renewal |
-
-To review credits, see
-[Credits](/manuals/subscription-billing/manage/_index.md#credits).
+The available options depend on the plan. For example, Docker plans let you
+add seats or switch to annual billing, while product plans let you upgrade
+or downgrade tiers, add units, or turn auto-renewal on or off. For the
+steps for each plan and when the change takes effect, see the
+[plans catalog](/manuals/subscription-billing/plans/_index.md).
 
 ## Sales-led products
 
diff --git a/content/manuals/subscription-billing/plans/_index.md b/content/manuals/subscription-billing/plans/_index.md
index 5f667c2c3866..d94a15dcd87f 100644
--- a/content/manuals/subscription-billing/plans/_index.md
+++ b/content/manuals/subscription-billing/plans/_index.md
@@ -48,18 +48,16 @@ grid:
 
 
 Docker plans attach to an individual account, an organization, or a specific
-product. 
+product. Plans make up your subscription.
 
-* Docker Personal and Docker Pro are subscriptions for individual
-accounts. 
+* Docker Personal and Docker Pro are subscriptions for individual accounts.
 * Docker Team and Docker Business are subscriptions for organization
-accounts. 
-* Product plans let you subscribe to a Docker product without altering 
-your account type plan. 
+  accounts.
+* Product plans let you subscribe to a Docker product without altering
+  your account type plan.
 
 Each plan page covers usage entitlements, billing cycle, and management
-options. To add or upgrade a plan, see
-[Manage plans](/manuals/subscription-billing/manage/plans.md).
+options.
 
 ## Choose a plan
 
@@ -67,17 +65,13 @@ Compare billing models and tiers before you subscribe.
 
 | Plans | Billing model | Types |
 | --- | --- | --- |
-| [Docker](/manuals/subscription-billing/plans/docker.md) | Flat-rate plans for personal and organization accounts | Docker Personal, Docker Pro, Docker Team, Docker Business |
+| [Docker](/manuals/subscription-billing/plans/docker.md) | Flat-rate plans for individual and organization accounts | Docker Personal, Docker Pro, Docker Team, Docker Business |
 | [Docker Hardened Images (DHI)](/manuals/subscription-billing/plans/dhi.md) | Annual plans billed per repository. DHI Community is free. | DHI Community, DHI Select, DHI Enterprise |
 | [Gordon](/manuals/subscription-billing/plans/gordon.md) | Monthly plans that raise your Gordon usage allowance | Gordon Plus, Gordon Max, Gordon Ultra |
 | [Docker Agentic Platform](/manuals/subscription-billing/plans/docker-agentic-platform.md) | Pay-as-you-go cloud compute, billed monthly | Pay-as-you-go |
-| [AI Governance](/manuals/subscription-billing/plans/ai-governance.md) | Licenses purchased through Docker sales. <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_plans_index_aigov" class="link" rel="noopener">Contact sales</a> to add more. | AI Governance |
+| [AI Governance](/manuals/subscription-billing/plans/ai-governance.md) | Licenses purchased through Docker sales. | AI Governance |
 | [Docker Verified Publisher (DVP)](/manuals/subscription-billing/plans/docker-verified-publisher.md) | Flat-rate annual plans. DVP Growth lets you add consuming domains in blocks of 25. | DVP Starter, DVP Growth |
 
-Docker plans that upgrade your account (Docker Pro, Team, and Business) cover
-most use cases. Some product plans require an upgraded Docker account while others
-let you subscribe without one.
-
 ## Add units to a plan {#top-up-your-plan}
 
 Add seats, minutes, or other units without changing the plan type.
@@ -86,9 +80,9 @@ Add seats, minutes, or other units without changing the plan type.
 | --- | --- | --- |
 | [Seats](/manuals/accounts/organization/manage/manage-seats.md) | Each seat extends entitlements to one more member. | Docker Team, Docker Business |
 | [Licenses](/manuals/accounts/organization/manage/manage-licenses.md) | Access to specific products or features. | AI Governance, Docker Offload |
-| [Minutes](/manuals/subscription-billing/plans/docker.md#docker-build-cloud-minutes) | Build and test runtime capacity, sold in blocks and consumed within the billing period. | Docker Build Cloud, [Testcontainers Cloud](/manuals/subscription-billing/plans/docker.md#testcontainers-cloud-minutes) |
+| [Minutes](/manuals/subscription-billing/plans/docker.md#docker-build-cloud-minutes) | Build and test runtime capacity, sold in blocks and consumed within the billing period. | Docker Build Cloud, Testcontainers Cloud |
 | [Repositories](/manuals/subscription-billing/plans/dhi.md) | Additional container repositories covered by security scanning and analysis features. | DHI |
-| [Consuming domains](/manuals/subscription-billing/plans/docker-verified-publisher.md#add-consuming-domains) | Additional consuming domains tracked in publisher analytics, sold in blocks of 25. | DVP Growth |
+| [Consuming domains](/manuals/subscription-billing/plans/docker-verified-publisher.md#add-consuming-domains) | Additional consuming domains tracked in publisher analytics. | DVP Growth |
 
 ## Product catalog
 
diff --git a/content/manuals/subscription-billing/plans/ai-governance.md b/content/manuals/subscription-billing/plans/ai-governance.md
index 4920eff82989..8974be8af030 100644
--- a/content/manuals/subscription-billing/plans/ai-governance.md
+++ b/content/manuals/subscription-billing/plans/ai-governance.md
@@ -14,11 +14,11 @@ aliases:
   - /subscription/ai-governance/
 ---
 
-[AI Governance](/manuals/ai/sandboxes/governance/_index.md) lets organization owners enforce policies for members across supported Docker AI products, like [Docker Sandbox](/manuals/ai/sandboxes/_index.md). When you add an AI Governance plan, you work with your Docker sales representative to determine the number of licenses needed, which are applied to your account.
-
 > [!TIP]
 > To subscribe to AI Governance, <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_plans_aigov" class="link" rel="noopener">contact sales</a>.
 
+[AI Governance](/manuals/ai/sandboxes/governance/_index.md) lets organization owners enforce policies for members across supported Docker AI products, like [Docker Sandbox](/manuals/ai/sandboxes/_index.md). When you add an AI Governance plan, you work with your Docker sales representative to determine the number of licenses needed, which are applied to your account.
+
 ## Usage
 
 AI Governance lets organization owners enforce [organization policies](/manuals/ai/sandboxes/governance/access-controls/organization.md) for license-holding members. Organization policies override a license-holding member's local policies.
diff --git a/content/manuals/subscription-billing/plans/docker-verified-publisher.md b/content/manuals/subscription-billing/plans/docker-verified-publisher.md
index 2724f88fd9f5..4e712d58b2a3 100644
--- a/content/manuals/subscription-billing/plans/docker-verified-publisher.md
+++ b/content/manuals/subscription-billing/plans/docker-verified-publisher.md
@@ -13,6 +13,10 @@ aliases:
   - /subscription/plans/docker-verified-publisher/
 ---
 
+> [!TIP]
+> DVP plans require an approved application before you can subscribe.
+> See [Apply for DVP Starter or Growth](#apply-for-dvp-starter-or-growth).
+
 [Docker Verified Publisher (DVP)](/manuals/docker-hub/repos/manage/trusted-content/dvp-program.md)
 is a program for commercial publishers who distribute content on Docker
 Hub. DVP Starter and DVP Growth are paid organization plans that add
@@ -28,10 +32,6 @@ publisher analytics and reporting to verified publisher status.
 For a plan comparison, see the
 [DVP landing page](https://hub.docker.com/publisher-program).
 
-> [!TIP]
-> DVP plans require an approved application before you can subscribe.
-> See [Apply for DVP Starter or Growth](#apply-for-dvp-starter-or-growth).
-
 ## Usage
 
 Organizations can hold a DVP plan and DVP entitlements apply per organization

From b2f5b3c6b01c41b3e0cca60ba75abee601b8f238 Mon Sep 17 00:00:00 2001
From: Alexa <alexa.kristensen@docker.com>
Date: Thu, 22 Oct 2026 09:10:49 -0500
Subject: [PATCH 5/5] personal account to individual account when not referring
 to plan type

---
 content/manuals/subscription-billing/manage/details.md | 2 +-
 content/manuals/subscription-billing/manage/history.md | 2 +-
 content/manuals/subscription-billing/manage/plans.md   | 2 +-
 content/manuals/subscription-billing/plans/_index.md   | 2 +-
 content/manuals/subscription-billing/plans/docker.md   | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/content/manuals/subscription-billing/manage/details.md b/content/manuals/subscription-billing/manage/details.md
index 63bfbaf5b832..15cb1381712f 100644
--- a/content/manuals/subscription-billing/manage/details.md
+++ b/content/manuals/subscription-billing/manage/details.md
@@ -17,7 +17,7 @@ You can update your billing details for Docker individual accounts and Docker or
 
 To update your billing information from **Settings** in Docker Home:
 
-1. Sign in to [Docker Home](https://app.docker.com/) and select your personal or organization
+1. Sign in to [Docker Home](https://app.docker.com/) and select your individual or organization
    account.
 1. Select **Billing**, then go to **Settings**.
 1. Select **Edit** to make your changes.
diff --git a/content/manuals/subscription-billing/manage/history.md b/content/manuals/subscription-billing/manage/history.md
index 2bfd4fad7bce..62a8792697e4 100644
--- a/content/manuals/subscription-billing/manage/history.md
+++ b/content/manuals/subscription-billing/manage/history.md
@@ -18,7 +18,7 @@ needed.
 Individual accounts and organization accounts use the same steps to view billing
 history. To view your billing history:
 
-1. Sign in to [Docker Home](https://app.docker.com/) and select your personal
+1. Sign in to [Docker Home](https://app.docker.com/) and select your individual
    account or organization account.
 1. Select **Billing**, then **Invoices**.
 1. View an individual invoice by selecting:
diff --git a/content/manuals/subscription-billing/manage/plans.md b/content/manuals/subscription-billing/manage/plans.md
index b35fe0ef2f7f..5c6429a4f1da 100644
--- a/content/manuals/subscription-billing/manage/plans.md
+++ b/content/manuals/subscription-billing/manage/plans.md
@@ -27,7 +27,7 @@ self-serve Docker products, while the Overview page shows your active plans with
 
 You can purchase Docker Team, Docker Business, and other products through the product catalog:
 
-1. Sign in to [Docker Home](https://app.docker.com/), then choose your personal
+1. Sign in to [Docker Home](https://app.docker.com/), then choose your individual
    account or your organization account.
 1. Go to **Billing**.
 1. Select **Browse products**.
diff --git a/content/manuals/subscription-billing/plans/_index.md b/content/manuals/subscription-billing/plans/_index.md
index d94a15dcd87f..c3bf2e58d019 100644
--- a/content/manuals/subscription-billing/plans/_index.md
+++ b/content/manuals/subscription-billing/plans/_index.md
@@ -28,7 +28,7 @@ grid:
     link: /subscription-billing/plans/gordon/
     icon: /icons/gordon.svg
   - title: Docker Agentic Platform
-    description: Pay-as-you-go cloud compute for personal accounts.
+    description: Pay-as-you-go cloud compute for individual accounts.
     link: /subscription-billing/plans/docker-agentic-platform/
     icon: cloud
   - title: Docker Hardened Images (DHI)
diff --git a/content/manuals/subscription-billing/plans/docker.md b/content/manuals/subscription-billing/plans/docker.md
index 0352fc08d182..70ce20132870 100644
--- a/content/manuals/subscription-billing/plans/docker.md
+++ b/content/manuals/subscription-billing/plans/docker.md
@@ -2,7 +2,7 @@
 title: Docker plans
 linkTitle: Docker
 description:
-  Learn about Docker plans that upgrade personal and organization accounts,
+  Learn about Docker plans that upgrade individual and organization accounts,
   including usage entitlements, billing cycle, and downgrade options.
 keywords:
   docker team, docker business, docker pro, docker personal,