Change your subscription

Table of contents

Important

Starting July 1, 2024, Docker will begin collecting sales tax on subscription fees in compliance with state regulations for customers in the United States. For our global customers subject to VAT, the implementation will start rolling out on July 1, 2024. Note that while the roll out begins on this date, VAT charges may not apply to all applicable subscriptions immediately.

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.

The following sections describe how to change plans when you have a Docker subscription plan or legacy Docker subscription plan.

Note

Legacy Docker plans apply to Docker subscribers who last purchased or renewed their subscription before December 10, 2024. These subscribers will keep their current plan and pricing until their next renewal date that falls on or after December 10, 2024. To see purchase or renewal history, view your billing history. For more details about legacy subscriptions, see Announcing Upgraded Docker Plans.

Upgrade your subscription

When you upgrade a Docker plan, you immediately have access to all the features and entitlements available in your Docker subscription plan. For detailed information on features available in each subscription, see Docker Pricing.

To upgrade your Docker subscription:

  1. Sign in to Docker Home.
  2. Under Settings and administration, select Billing.
  3. Optional. If you're upgrading from a free Personal plan to a Team plan and want to keep your username, convert your user account into an organization.
  4. Select the account you want to upgrade in the drop-down at the top-left of the page.
  5. Select Upgrade.
  6. Follow the on-screen instructions to complete your upgrade.

You can upgrade a legacy Docker Core, Docker Build Cloud, or Docker Scout subscription plan to a Docker subscription plan that includes access to all tools.

Contact Docker sales to upgrade your legacy Docker plan.

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.

When you downgrade your subscription, access to paid features is available until the next billing cycle. The downgrade takes effect on the next billing cycle.

Important

If you downgrade your personal account from a Pro subscription to a Personal subscription, note that Personal subscriptions don't include collaborators for private repositories. Only one private repository is included with a Personal subscription. When you downgrade, all collaborators will be removed and additional private repositories are locked. Before you downgrade, consider the following:

  • Team size: You may need to reduce the number of team members and convert any private repositories to public repositories or delete them. For information on features available in each tier, see Docker Pricing.
  • SSO and SCIM: If you want to downgrade a Docker Business subscription and your organization uses single sign-on (SSO) for user authentication, you need to remove your SSO connection and verified domains before downgrading. After removing the SSO connection, any organization members that were auto-provisioned (for example, with SCIM) need to set up a password to sign in without SSO. To do this, users can reset their password at sign in.

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

To downgrade your Docker subscription:

  1. Sign in to Docker Home.
  2. Under Settings and administration, select Billing.
  3. Select the account you want to downgrade in the drop-down at the top-left of the page.
  4. Select the action icon and then Cancel subscription.
  5. Review the cancellation warnings, then select Confirm cancellation.
  6. Optional. Fill out the feedback survey, or select Skip.

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

Downgrade Legacy Docker plan

To downgrade your legacy Docker subscription:

  1. Sign in to Docker Hub Billing.
  2. Select the account you want to downgrade in the drop-down at the top-left of the page.
  3. Select the link to Manage this account on Docker Hub.
  4. In the plan section, select Change plan.
  5. Follow the on-screen instructions to complete your downgrade.

Downgrade Docker Build Cloud subscription

To downgrade your Docker Build Cloud subscription:

  1. Sign in to Docker Home and open Docker 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).

Pause a subscription

You can't pause or delay a subscription. If a subscription invoice hasn't been paid on the due date, there's a 15 day grace period, including the due date.