Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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

16 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
0 votes

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

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

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
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,827 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you