How to change the main branch
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Summary
You may, at some point, wish to change the main branch used by your repository in Bitbucket Cloud.
Environment
Bitbucket Cloud repository
Solution
To change the current main branch to a different branch, you will need to follow the steps below:
The following steps will need to be performed by a repository administrator, if you do not have repository administrator permissions - you will need to reach out to a user who does and have them perform the steps outlined below.
- Create a new branch from the current main branch (if not already created)
- Access Repository Settings > Repository Details and expand the Advanced dropdown to reveal the branch options
- In the Main Branch dialogue select the new branch from the dropdown list that you want to set as the main branch
- Click Save Changes when complete
If you are issues after following the steps within this article, please feel free to raise a support ticket or raise a community support ticket for further assistance.
Last modified on Mar 7, 2025
Powered by Confluence and Scroll Viewport.