Change your subscription

Table of contents
Important

For United States customers, Docker began collecting sales tax on July 1, 2024. For European customers, Docker began collecting VAT on March 1, 2025. For United Kingdom customers, Docker began collecting VAT on May 1, 2025.

To ensure that tax assessments are correct, make sure that your billing information and VAT/Tax ID, if applicable, are updated. If you're exempt from sales tax, see Register a tax certificate.

You can upgrade or downgrade your Docker subscription at any time to match your changing needs. This page explains how to make subscription changes and what to expect with billing and feature access.

Note

Legacy Docker subscribers have different interfaces for subscription changes. Legacy subscriptions apply to subscribers who last purchased or renewed before December 10, 2024. For details, see Announcing Upgraded Docker Plans.

Upgrade your subscription

When you upgrade your Docker subscription, you immediately get access to all features and entitlements in your new subscription tier. For detailed feature information, see Docker Pricing.

To upgrade your subscription:

  1. Sign in to Docker Home and select the organization you want to upgrade.
  2. Select Billing.
  3. Optional. If you're upgrading from a free Personal subscription to a Team subscription and want to keep your username, convert your user account into an organization.
  4. Select Upgrade.
  5. Follow the on-screen instructions to complete your upgrade.
Note

If you choose to pay using a US bank account, you must verify the account. For more information, see Verify a bank account.

To upgrade your legacy Docker subscription to a new Docker subscription that includes access to all tools, contact Docker sales.

Downgrade your subscription

You can downgrade your Docker subscription at anytime before the renewal date. The unused portion of the subscription isn't refundable or creditable.

You can downgrade your Docker subscription at any time before the renewal date. The unused portion isn't refundable, but you retain access to paid features until the next billing cycle.

Downgrade considerations

Consider the following before downgrading:

  • Team size and repositories: You may need to reduce team members and convert private repositories to public or delete them based on your new subscription limits.
  • SSO and SCIM: If downgrading from Docker Business and your organization uses single sign-on, remove your SSO connection and verified domains first. Organization members who were auto-provisioned through SCIM need to reset their passwords to sign in without SSO.
  • Private repository collaborators: Personal subscriptions don't include collaborators for private repositories. When downgrading from Pro to Personal, all collaborators are removed and additional private repositories are locked.

For feature limits in each tier, see Docker Pricing.

Important

If you have a sales-assisted Docker Business subscription, contact your account manager to downgrade your subscription.

To downgrade your subscription:

  1. Sign in to Docker Home and select the organization you want to downgrade.
  2. Select Billing.
  3. Select the action icon and then Cancel subscription.
  4. Fill out the feedback survey to continue with cancellation.
Important

If you have a sales-assisted Docker Business subscription, contact your account manager to downgrade your subscription.

To downgrade your legacy Docker subscription:

  1. Sign in to Docker Hub.
  2. Select the organization you want to downgrade, then select Billing.
  3. To downgrade, you must navigate to the upgrade plan page. Select Upgrade.
  4. On the upgrade page, select Downgrade in the Free Team plan card.
  5. Follow the on-screen instructions to complete your downgrade.

To downgrade your Docker Build Cloud subscription:

  1. Sign in to Docker Home and select Build Cloud.
  2. Select Account settings, then Downgrade.
  3. To confirm your downgrade, type DOWNGRADE in the text field and select Yes, continue.
  4. The account settings page will update with a notification bar notifying you of your downgrade date (start of next billing cycle).

Subscription pause policy

You can't pause or delay a subscription. If a subscription invoice isn't paid by the due date, there's a 15-day grace period starting from the due date.