Rename organizations and repositories
2 months ago
This page details everything you need to know about renaming organizations and repositories connected to CircleCI. Renaming works differently depending on how your account is connected:
| VCS integration | Rename organization | Rename repository | Rename project | Notes |
|---|---|---|---|---|
GitHub App |
Yes |
Yes |
No |
Changing the name of a repository does not affect the name of the project in CircleCI. The project name remains the same. |
GitLab |
Yes |
Yes |
No |
Changing the name of a repository does not affect the name of the project in CircleCI. The project name remains the same. |
Bitbucket Data Center |
Yes |
Yes |
No |
Changing the name of a repository does not affect the name of the project in CircleCI. The project name remains the same. |
GitHub OAuth app |
Yes |
Yes |
Yes |
Org and repository names map directly to org and project names in CircleCI. Changing either by following these steps will update the corresponding name in CircleCI. |
Bitbucket Cloud |
Yes |
Yes |
Yes |
Org and repository names map directly to org and project names in CircleCI. Changing either by following these steps will update the corresponding name in CircleCI. |
| To find out if you authorized through the GitHub OAuth app or the CircleCI GitHub App, see the GitHub App integration page. |
GitHub App, GitLab, Bitbucket Data Center
For CircleCI organizations integrated through the GitHub App, GitLab or Bitbucket Data Center, no changes are required when organizations or repositories are renamed in the connected VCS (version control system). CircleCI organizations and projects are standalone entities, not directly tied to code repository or org names.
You can rename your organization from the CircleCI web app:
-
Select Organization Settings in the sidebar.
-
Select Rename Organization next to your org name.
-
Enter a new name for your org and select Save.
GitHub OAuth app or Bitbucket Cloud
If you need to rename a GitHub (OAuth app) or Bitbucket Cloud 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
| It is not possible to rename projects that use CircleCI’s GitHub App, Bitbucket Data Center, or GitLab integrations. The following instructions are for orgs and projects that use CircleCI’s GitHub OAuth App or Bitbucket Cloud integrations. |
-
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