Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Is there a way to rename a branch?

I apparently have some branches out of sync; is there a way to rename a branch?

7 answers

17 votes
Mikael Sandberg Community Leader Mar 15, 2018

You would need to do the renaming locally in your repository. But before you do that, delete the branch in Bitbucket, do a fetch in your local clone to update it (if doing it from Sourcetree, make sure you check prune tracking branches, from cmd use git fetch -p). Then you can rename the branch and push it back to Bitbucket.

This might be helpful too.


Officially I don't see a way to rename them, but we have had to do that in some cases.  What we do is basically the following

We have branch bugfix/JIRA-1  and want to rename it to bugfix/JIRA-100
All I usually do is take bugfix/JIRA-1 and create a branch off of that called bugfix/JIRA-100
At that point 1 and 100 should be identical.
I can then delete bugfix/JIRA-1.

You could do this via the bitbucket UI or command line as GErhard_Pretorius linked above.  I personally like the UI in this case as it saves me the step of having to push to origin.

To summarize the other answers: No, there is no way to rename.  You can copy and delete, to achieve a similar effect.  But if there is, say, a pull request in progress, you can't avoid losing the comments and approvals.

this seems to me to be an annoying missing feature of bitbucket!

Like # people like this

So to summarise:

- git pull (locally cloned, to get latest changes)

- delete remote branch on BitBucket

- git fetch -p

- git branch -m <branch_name>

- git push -u <remote> <branch_name> (push to remote)




- create new branch from the branch in BitBucket

- delete the prev branch

while on the current branch: git branch -m "local_branch_name"

if you are doing it from visual studio, in team explorer, right click the branch and rename, one issue i had was renaming the branch to lower case (Dev -> dev), in that case i just renamed to dev1 and then to dev. Hope this helps.

Linux and Windows work differently with case sensitivity.  While on linux you can have branch1 and Branch1, that will cause a conflict on windows.  If you are a cross platform shop, you can configure bitbucket to ignore case on branch names.

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events