How To Rename a Local and Remote Git Branch 2023

How To Rename a Local and Remote Git Branch

When working on a collaborative project with a team, it’s important to establish a git branch naming convention to maintain organization and structure. However, if you find that you have mistakenly named a branch incorrectly after creating it and pushing the changes to the remote repository, there are steps you can take to correct the error.

By using git branch -m command, you can rename the branch very easily.

This tutorial will show you how to rename a local and remote Git branch.

How to Rename Local Git Branch

To rename a local Git branch follow the below steps:

1. Use git checkout to switch to the local branch that you want to rename:

git checkout <old_name>

2. Rename the local branch by using the following command:

git branch -m <new_name>

After entering the above command, the local branch name will be changed to the new name that you have provided.

How to Rename Remote Git Branch

If you have already pushed the local branch with the old name to the remote repositories, then you need to follow the next steps to rename the remote branch.

1. Use git push origin -u command and push the new name local branch and reset the upstream branch:

git push origin -u <new_name>

2. Now, delete the old name of the remote branch:

git push origin --delete <old_name>

With this step, you have successfully renamed the remote git branch.


Branches are an essential aspect of software development using Git, offering an array of powerful features. They function as pointers to specific commits and serve as the foundation for effective version control. By leveraging branches, developers can effortlessly manage changes, experiment with new ideas, and collaborate with team members. Incorporating branches into your software development workflow can significantly enhance your productivity and project management capabilities.

o rename a Git branch locally, you can use a simple command. However, it’s not possible to directly rename a remote branch. To rename a remote branch, you’ll need to push the renamed local branch and then delete the old branch with the previous name. This process can be easily accomplished with a few simple steps.

If you still have any questions feel free to comment below.



Hi, this is James, a tech specialist and a core member of the TrioTeam. I like to research and write content about various interesting things especially tech-related stuff, and also have an interest in philosophical discussion. I have been writing solutions for technical problems, how-to tutorials, technology reviews, tools and websites, and so on for TrioGuide.

We will be happy to hear your thoughts

Leave a reply