docs: refresh billing documentation#25567
Open
akristen wants to merge 12 commits into
Open
Conversation
Co-authored-by: Cursor <cursoragent@cursor.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
…freshness-round1 Co-authored-by: Cursor <cursoragent@cursor.com> # Conflicts: # content/manuals/billing/3d-secure.md # content/manuals/billing/details.md # content/manuals/billing/history.md # content/manuals/billing/tax-certificate.md
…freshness-round1
…nt flows Removes the standalone billing cycle page and folds its content into a new section on the billing details page, and updates payment method and invoice flows to match the current billing portal UI. Co-authored-by: Cursor <cursoragent@cursor.com>
Restructures the invoice history page around a view/understand flow, moves VAT number guidance into billing details, and updates the tax certificate page's link accordingly. Co-authored-by: Cursor <cursoragent@cursor.com>
Use 'username' instead of 'account name' and hyphenate 'sign-in' to satisfy Docker.RecommendedWords and Vale.Spelling checks. Co-authored-by: Cursor <cursoragent@cursor.com>
Adds a Sales tax and VAT overview section to the billing index, restores the VAT/Tax ID step to the plan purchase procedure where it belongs, and repoints faqs.md and tax-certificate.md links to the new canonical location instead of the removed history.md anchor. Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions
Bot
added
the
area/subscription
akristen
marked this pull request as ready for review
July 15, 2026 16:35
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
Broadens the intro to cover contact info and address, not just email, and drops the now-inaccurate "Change payment method" modal reference and stale tax ID/VAT mentions from the description and keywords, since that guidance moved to the plan purchase flow. Co-authored-by: Cursor <cursoragent@cursor.com>
Matches the actual UI element name (singular) across all three references; two instances incorrectly used the plural form. Co-authored-by: Cursor <cursoragent@cursor.com>
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
Drops the erroneous reference to the default payment method from the "Remove payment method" procedure, since that section is for removing a secondary method. Clarifies that renewal dates are set per plan rather than pointing only to the Plans page without context, and strips trailing whitespace flagged by Prettier in history.md. Co-authored-by: Cursor <cursoragent@cursor.com>
aevesdocker
reviewed
Jul 16, 2026
aevesdocker
left a comment
aevesdocker
left a comment
Contributor
There was a problem hiding this comment.
very noice. minor comments
| 1. Select **Invoices** and locate the invoice you want to pay. | ||
| 1. In the **Actions** column, select **Pay invoice**. | ||
| 1. Fill out your payment details and select **Pay**. | ||
| | Invoice field | Description | |
Contributor
There was a problem hiding this comment.
ooo yes, tables. way better
akristen
commented
Jul 16, 2026
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Co-authored-by: Alexa Kristensen <81787716+akristen@users.noreply.github.com>
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
akristen
commented
Jul 16, 2026
Co-authored-by: Alexa Kristensen <81787716+akristen@users.noreply.github.com>
usha-mandya
reviewed
Jul 21, 2026
|
|
||
| ## Docker plans and billing behaviors | ||
|
|
||
| Your invoice history is a reference to the Docker plans you subscribe to. To understand more about how you were invoiced, such as renewal dates and billing cycles, review the [plan details](/manuals/subscription/plans/_index.md) |
Member
There was a problem hiding this comment.
Could you simplify "To understand more about how you were invoiced, such as renewal dates and billing cycles, review the plan details for what you've subscribed to."
Something on the lines of "For information about your billing cycle and renewal dates, see plan details .
usha-mandya
reviewed
Jul 21, 2026
| 1. Sign in to [Docker Home](https://app.docker.com/) and select your personal or organization | ||
| account. | ||
| 1. Select **Billing**, then go to **Settings**. | ||
| 1. Select **Edit**, then choose **Update** next to your current billing contact and billing address information. |
Member
There was a problem hiding this comment.
I was looking for the Update option immediately after I clicked Edit. Can we clarify that users should select Update after they change any details?
usha-mandya
reviewed
Jul 21, 2026
| account. | ||
| 1. Select **Billing**, then go to **Settings**. | ||
| 1. Select **Edit**, then choose **Update** next to your current billing contact and billing address information. | ||
| 1. Verify your information, then select **Save as default**. |
Member
There was a problem hiding this comment.
Is this missing the TAX ID and VAT option
usha-mandya
reviewed
Jul 21, 2026
| | Category | Payment type | | ||
| | ------------- | ----------------------------------------------------------------------- | | ||
| | Cards | Visa, MasterCard, American Express, Discover, JCB, Diners, UnionPay | | ||
| | Wallets | Stripe Link | |
usha-mandya
reviewed
Jul 21, 2026
| - You must be an existing Stripe Link customer, or fill out the card information form to use Link payments. | ||
| - Verify a | ||
| [bank account](#verify-a-bank-account) before choosing it as a payment method. | ||
| - Use an existing Stripe Link account, or enter your card information to set up |
Member
There was a problem hiding this comment.
Could you check the official term and update all Stripe Link / Link references?
usha-mandya
reviewed
Jul 21, 2026
| @@ -34,23 +33,27 @@ You can purchase Docker plans through the product catalog: | |||
| - Each product tile uses an account-type flag so you know the difference. | |||
| 1. Select **View plans** to add a plan to your Docker account. | |||
| 1. Verify your billing details, continue to payment, and complete checkout. | |||
Member
There was a problem hiding this comment.
Are we missing the Create your plan step here?
Member
|
Thanks @akristen. Left some minor comments. Looks good otherwise. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Consolidate duplicate billing content, fix docs that described an outdated portal UI, and delete a standalone page (cycle.md) by merging it into details.md.