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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


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
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
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.


Thanks! Worked perfectly.

Very helpful article, thanks for the link!

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
AUG Leaders

Atlassian Community Events