Support People In Ukraine
Ukraine was invaded by Russia in the early morning of 24.02.2022, explosions thundered in Ukrainian cities, many civilians died, tens of millions are affected. Our army protects all Europe from the occupiers and it needs help now to restrain one of the biggest armies in the world. Please, donate a small amount.
I Am
Volodymyr Hudyma
<FrontEndDeveloper />
You Are Here: Home/How To Rename Local And Remote Branch In Git?

How To Rename Local And Remote Branch In Git?

June 04, 2021

Table Of Contents

    In some cases, such as when you have named a branch that does not conform to the project standard, you need to rename it.

    It's a super simple task, but often developers forget either the commands or the exact order of arguments and they have to spend time googling it.

    Rename Local Branch

    To rename local branch, follow these steps:

    • Switch to a branch you want to rename
    git checkout <old_name>
    • Rename a branch
    git branch -m <new_name>

    The -m flag stands for (--move) and it is used to move/rename a branch and a corresponding reflog entry.

    If the branch with a new_name already exists, you should use -M (--move --force) flag to force the rename.

    One-Step Approach

    Sometimes you can't move to the branch you want to rename.

    The good thing is that you don't have to, use the following command:

    git branch -m <old_name> <new_name>

    Rename A Remote Branch

    Once you've managed to push the branch you want to rename to the remote branch, things get a little more complicated because you have to remember to change the upstream as well.

    Given you have renamed the branch locally:

    • Push it to the remote (with -u, or --set-upstream option):
    git push origin -u <new_name>
    • Delete an old branch on remote
    git push origin -d <old_name>

    Summary

    Working with branches in Git is an essential part of a successful software development process and knowing how to rename them properly is a must, as mistakes happen far too often.

    Renaming a local branch is a matter of just one command, but if the branch has been pushed to a remote, then you need to push the renamed local branch and delete the branch with the old name.

    Newsletter
    Receive all new posts directly to your e-mail
    No spam, only quality content twice a week
    Let me know what you think about this article
    Click here to write response...