Skip to main content

How to Transfer a CircleCI Plan to Another Org

If your org is restructuring, migrating repositories, or consolidating under a new version control setup, you may need to transfer your CircleCI plan from one org to another. This guide walks you through the process and outlines important details to consider.

When Should You Transfer a Plan?

Transferring your CircleCI plan is helpful in scenarios such as:

  • Migrating repositories to a new GitHub or Bitbucket organization

  • Company acquisitions or internal restructuring

  • Consolidating teams or billing under a parent organization

Transferring a plan ensures that your paid features, credits, and billing follow you to the new organization, avoiding service disruption and supporting business continuity.

If your plan is currently shared with other organizations (child orgs), you must unlink all of them before you can transfer the plan. Unlinking can be done from the Share & Transfer tab in your Plan settings. See @[Can I Share my Plan? Can I Stop Sharing my Plan?] for how to unlink a child org. Attempting a transfer while orgs are still linked can leave your plan in a bad state.

Before You Start: Unlink Any Shared Organizations

How to Transfer Your Plan

To transfer your CircleCI plan to a different organization:

  1. Log in to the CircleCI web app.

  2. In the sidebar, go to Plan.

  3. Click Share & Transfer.

  4. If you're on a paid plan (not Free), you'll see the Transfer Plan option.

  5. Select the target organization:

    • It must be on the Free Plan.

    • You must have admin access to both the source and target organizations.

  6. Follow the on-screen prompts to complete the transfer.

Important Notes

  • The original org will be downgraded to the Free Plan after the transfer.

  • You must have admin privileges for both organizations involved. If you are unable to see the organization under the transfer, this indicates that you are not an admin of the other organization.

  • All remaining credits and plan features (including billing) will move to the new organization.

    • For example, if the org you're keeping has 10 credits at the time of transfer, you'll still have those 10 credits after the transfer completes — the credits move with the plan, they aren't reset or lost.

  • If the target organization is already on a paid plan, it must first be downgraded to the Free Plan before the transfer can happen. Downgrading a paid org to Free means that org forfeits any remaining credits on its own plan — this happens before your plan's credits move over, so plan ahead if the target org still has credits it's using.

  • Transferring between two paid plans always requires contacting support — this can't be completed through self-serve UI. Please submit a request so our team can walk you through it. If the transfer involves any changes to your contract terms, you'll also need to work with your account team.

Transferring Between Two Paid Plans

If you need help during the transfer or have questions about plan eligibility, please submit your query request here.

  • GitLab organizations do not currently appear in the self-serve Transfer Plan UI. Contact support if you need to transfer a plan involving a GitLab org.

  • If the organization you're transferring from or to has been deleted from GitHub or Bitbucket but still has an active CircleCI plan, the standard transfer won't work. Contact support for help in this situation.

Did this answer your question?