DEV Community

Cover image for How to Rename Local and Remote Git Branch
Chirag
Chirag

Posted on • Originally published at kodewithchirag.com

How to Rename Local and Remote Git Branch

Have you ever wondered or come across a situation where you want to rename a Git branch? If yes then this article will help you with that. Earlier, I faced the same situation where I wanted to rename the git branch locally and on remote, and luckily I found that git allows us to rename the branch very easily, lets see how.

I will share the solutions to rename the git branch locally and under the remote.

Rename local git branch

If you are already in the local branch which you wanted to rename, you can hit this command.

git branch -m <new_name>
Enter fullscreen mode Exit fullscreen mode

If you are under another branch and want to rename the branch then hit the below command.

git branch -m <old_name> <new_name>
Enter fullscreen mode Exit fullscreen mode

Now check your current branch name by hitting

git status 

or

git branch 
Enter fullscreen mode Exit fullscreen mode

you will see the changes, isn’t it is so simple 😉

Rename remote git branch

If your local branch is already pushed to a remote repository and you want to rename it and reset the upstream branch then this command will help you to rename it.

git push origin -u <new_name>

git push origin --delete <old_name>
Enter fullscreen mode Exit fullscreen mode

Now if you want to check the changes then you can login to your GitHub or GitLab or whatever the git client portal you are using and see the changes there.

Conclusion

Renaming a local Git Branch is just a matter of running a single “git branch -m” command. However, you can’t directly rename a remote branch as you need to push the renamed local branch to the remote repository and then delete the old branch from there.

Hope you liked this article and found it useful, feel free to comment with your thoughts and opinions and stay connected with me here and on Twitter🐦.

Discussion (0)