Rename organizations and repositories
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
-
Rename organization or repository in your VCS
-
Go to the CircleCI web app using the new org/repo name, for example:
app.circleci.com/pipelines/<VCS>/<new-org-name>/<project-name>
-
Confirm that your plan, projects, and settings have been transferred successfully
-
If desired, you are now free to create a new org/repo with the previously-used name in your VCS
See also
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.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
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.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.