docs: clarify how to view and change plans

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
 

content/manuals/subscription-billing/manage/_index.md

@@ -1,28 +1,37 @@
 ---
 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
     description: Add a new plan, upgrade an active plan, or cancel auto-renewal.
     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
 

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.

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:

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**.
@@ -45,38 +45,18 @@ 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
+## Change an active plan {#upgrade-plans}
 
-You can upgrade active plans from the billing Overview page.
+To change a plan you already have, sign in to
+[Docker Home](https://app.docker.com/), go to **Billing**, then go to
+**Active subscriptions**. Each plan tile has a control, such as an action
+menu or a **Manage** button, that opens the options for that plan.
 
-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
-[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.
+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