Can I rename my organization?

Overview

Changing your organization name in CircleCI depends on how your account is connected to your version control system. The process varies significantly based on whether you're using GitHub App, GitLab, Bitbucket Data Center, GitHub OAuth App, Bitbucket Cloud, or email/password authentication. Understanding your specific integration type is crucial for successfully renaming your organization while preserving your project settings, environment variables, and build history.

Renaming Your Organization Based on Authentication Method

For GitHub App, GitLab, or Bitbucket Data Center Users

If you're authenticated via the GitHub App, GitLab, or Bitbucket Data Center, you can rename your organization directly from the CircleCI web app:

Navigate to Organization Settings in the sidebar
Select Rename Organization next to your organization name
Enter the new name and select Save

For GitHub OAuth App or Bitbucket Cloud Users

The organization name in CircleCI is directly mapped from your version control system for these integrations. To change it:

Rename your organization in your VCS (GitHub or Bitbucket)
Access CircleCI using the new organization name
Verify that your projects and settings are intact

Important: If you do not follow the recommended process, you may lose access to settings, environment variables, or contexts. Detailed steps are available in CircleCI's documentation.

Troubleshooting and Permissions

If you're unable to change your organization name after following the appropriate steps, ensure you have the necessary admin permissions. If issues persist, contact CircleCI Support for further assistance.

Additional Notes

Several important considerations apply when renaming organizations:

Project Name Behavior: For some integrations like the GitHub App, project names in CircleCI do not change even if you rename the repository in your VCS.

Risk of Data Loss: Renaming organizations or repositories can risk losing contexts, build history, and settings if not done carefully. Always verify your settings after making changes and before reusing old names for new organizations or repositories in your VCS.

Billing Information: If you need to update your company name for billing purposes, you must contact CircleCI Support directly, as this cannot be changed via the UI.

Getting Specific Help: If you need more specific assistance, provide details about your VCS integration and where you are encountering issues when contacting support.

Additional Resources