Start Building for Free

Rename organizations and repositories

7 months ago1 min read
On This Page

If you need to rename an organization or repository that you have previously connected to CircleCI, best practice is to follow the steps listed below. If you do not follow this process, it is possible you may lose access to your organization or repository settings, including environment variables and contexts.

Steps to rename organizations and repositories

  1. Rename organization or repository in your VCS

  2. Go to the CircleCI web app using the new org/repo name, for example:<VCS>/<new-org-name>/<project-name>

  3. Confirm that your plan, projects, and settings have been transferred successfully

  4. If desired, you are now free to create a new org/repo with the previously-used name in your VCS

Help make this document better

This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.

Need support?

Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.

You can also visit our support site to find support articles, community forums, and training resources.