{"id":15804,"date":"2021-09-16T14:35:00","date_gmt":"2021-09-16T14:35:00","guid":{"rendered":"https:\/\/www.hostinger.com\/tutorials\/?p=15804"},"modified":"2025-04-28T07:57:29","modified_gmt":"2025-04-28T07:57:29","slug":"how-to-rename-a-git-branch","status":"publish","type":"post","link":"\/tutorials\/how-to-rename-a-git-branch","title":{"rendered":"Git rename branch \u2013 learn how to rename a local and remote Git branch"},"content":{"rendered":"

Git is a Version Control System (VCS)<\/strong> used by developers to facilitate collaboration. It is useful for coordinating work and tracking source code changes during the software development process.<\/p>

When working in Git, developers utilize Git branches to add new features or repair bugs. A branch lets them make changes without affecting the original code. When a new branch is proven to work correctly, developers can merge it with the master branch.<\/p>

This article will briefly explain what Git repositories and Git branches are. It will also teach you how to rename local and remote Git branches in case you misname one or want your project to be better organized. We’ll also mention some helpful commands.<\/p>

Download complete GIT cheat sheet<\/a><\/p>

\n\n\n\n\n\n\n<\/p>

What Is a Git Repository?<\/h2>

Git is a Distributed Version Control System<\/strong> (DVCS)<\/strong> that provides all team members with access to the final version of a project. Git is designed with performance, security, and flexibility in mind to make project management easier.<\/p>

When learning Git basics<\/a>, you’ll run across the term repository<\/strong>. It acts like a folder for your project and contains all of its files as well as their revision history. Repositories can be private or public and can be shared with other people.<\/p>

When you create a Git repository, a .git\/<\/strong> directory appears in the root of the project folder. Here, Git tracks changes of project files, stores objects, refs<\/a>, and additional repository management information.<\/p>

Be careful not to delete the .git\/ <\/strong>folder on accident because doing so will result in the loss of your project’s history.<\/p>

We recommend using GitHub<\/a> as the centralized location for your repositories as its features facilitate collaboration and let users manage code more efficiently.<\/p>

What Are Git Branches?<\/h2>

Git branches are isolated lines of your project’s development. They provide a way to work alongside your master branch, keeping it clear of clutter or any code that’s not yet finished.<\/p>

A branch acts as a pointer to a commit<\/a> – a snapshot of the changes you’ve made or wish to make. It is useful when you want to add additional features or fix a bug. It’s possible to create, delete, and list branches.<\/p>

Branches also prevent unstable code from being merged with the master branch of a project. <\/p>

How to Rename a Local Git Branch?<\/h2>

Before we begin, make sure you’ve selected the branch you want to rename. Run this command to do so:<\/p>

git checkout old-name<\/code><\/p>

Replace old-name<\/code> with the name of the appropriate branch.<\/p>

If you want to see all of your local branches, input the following command:<\/p>

git branch --list<\/code><\/p>

When you’ve selected the right branch, follow these steps:<\/p>

    \n
  1. Using the Git branch<\/strong> command, add an -m<\/strong> option to your line:<\/li>\n<\/ol>

    git branch -m new-name<\/code><\/p>

      \n
    1. Alternatively, you can rename a local branch by running the following commands:<\/li>\n<\/ol>

      git checkout master<\/code><\/p>

      Then, rename the branch by running:<\/p>

      git branch -m old-name new-name<\/code><\/p>

        \n
      1. Lastly, run this command to list all local and remote Git branches and verify that the renaming was successful:<\/li>\n<\/ol>

        git branch -a<\/code><\/p>

        How to Rename a Remote Git Branch?<\/h2>

        Unlike renaming a local branch, it isn’t possible to rename a remote branch directly. Instead, you’ll have to delete the old remote branch name and push<\/a> a new branch name to the remote repository.<\/p>

        The renaming process is simple – follow these steps:<\/p>

          \n
        1. To start, you will need to rename a local branch by following the previous steps using the -m<\/strong> option.<\/li>\n\n\n\n
        2. Then, delete<\/strong> the old<\/strong> branch<\/strong> and push<\/strong> the new one<\/strong>. Do this by inputting the following command:<\/li>\n<\/ol>

          git push origin --delete old-name<\/code><\/p>

            \n
          1. Finish by resetting the upstream branch for your new local one:<\/li>\n<\/ol>

            git push origin -u new-name<\/code><\/p>

            Alternatively, you can rename a remote git branch by overwriting it with the command below:<\/p>

            git push origin :old-name new-name\ngit push origin –u new-name<\/pre>
            How to Create a New Local Git Branch?<\/h2>
            Before creating a new branch, it’s essential to understand what Git commit <\/strong>is. It refers to a command that saves changes to a local repository. Git commit<\/strong> captures snapshots of changes happening within a specific project.<\/p>
            When you create a new local Git branch, Git establishes a new pointer to it.<\/p>
            With the concept cleared up, we can create a new local branch:<\/p>
              \n
            1. Navigate to the root of your master branch:<\/li>\n<\/ol>
              cd repository-name<\/code><\/p>
                \n
              1. Create a new branch via the following command:<\/li>\n<\/ol>
                git branch new-branch-name<\/code><\/p>
                  \n
                1. Alternatively, you can create a new branch and switch to it using the checkout <\/strong>command:<\/li>\n<\/ol>
                  git checkout -b new-branch-name<\/code><\/p>
                  The -b<\/strong> option tells Git to run the Git branch<\/strong> command before Git checkout<\/strong>.<\/p>
                  You can instead clone a branch and switch to it:<\/p>
                  git checkout -b new-branch-name origin\/new-branch-name<\/code><\/p>
                    \n
                  1. Next, switch to your new branch:<\/li>\n<\/ol>
                    git checkout new-branch-name<\/code><\/p>
                      \n
                    1. Finally, verify that you are on the new branch using the command below:<\/li>\n<\/ol>
                      git status<\/code><\/p>
                      How to Remove a Local Git Branch?<\/h2>
                      When a developer successfully adds new features, it is recommended to delete the Git branches<\/a> used in development as they no longer serve a purpose and can clutter your code.<\/p>
                      Note that Git will refuse<\/strong> to delete a branch containing commits that haven’t been merged into a remote branch or a repository.<\/p>
                      To remove a local branch, use one of the following Git commands<\/a>:<\/p>
                      git branch -d branch_name\ngit branch -D branch_name<\/pre>
                      The -d<\/strong> option (–delete<\/strong>) will remove your local branch if you have already pushed and merged it with the remote branch.<\/p>
                      The -D<\/strong> option (–delete –force<\/strong>) will remove the local branch regardless of whether it’s been merged or not.<\/p>
                      How to Remove a Remote Git Branch?<\/h2>
                      You can also remove a remote Git branch by specifying the names of both the remote repository and the branch. In most cases, the name of the remote repository will be origin<\/strong>, and the command will look like this:<\/p>
                      git push origin --delete branch_name\ngit push origin :branch_name<\/pre>
                      Inspection and Comparison<\/h2>
                      In Git, you can view any changes that you’ve made. To see them, enter the following command:<\/p>
                      git log<\/code><\/p>
                      For a more detailed summary, input this command:<\/p>
                      git log --summary<\/code><\/p>
                      These commands will return a list of every commit made within a repository.<\/p>
                      If you’re looking for a specific commit, combing through all of them may be too time-consuming. Fortunately, there are a few flags that you can use to filter the output:<\/p>