Common Ways to Rename, Change or Remove Git Branches

2 0 Jul 05, 2021

Common Ways to Rename, Change or Remove Git Branches

In this post, renaming, changing and removing a Git branch will be explained in details by commands on Git Bash.

It is important that you read every section carefully and check the other posts linked in the introduction section in case more information is needed on separate topics on Git.

Introduction to managing your Git branches

In almost every organization that's running small to large-size projects under a source control, like Git, the need to branch out specific updates, or commits, is inevitable.

Keeping your commits on a separate branch makes it reliable for the other team members to push hot fixes to the master branch version without worrying about your updates or any conflicts that they will cause when the final merge happens.

Dealing with branches, developers tend to need some common tasks like changing the name of the current branch (or another branch), move from one branch to another when they are in the middle of a task, and they need to hop into another one before they push the current branch, also deleting branches is needed on a daily basis.

That's why we gathered all those simple operations in one post to make them easier for developers to do them with a solid reference.

The following sections explain how to rename, change or remove Git branches using Git bash commands and some other IDEs:

How to rename a Git branch.
How to change the current Git branch.
How to delete Git branches

Prerequisites

This post assumes that you have a considerable knowledge of the following:

How to rename a Git branch

Common scenarios renaming Git branches are:

Renaming the current branch.
Renaming a separate branch other than the current one.
Renaming a remote branch.

Renaming the current branch

Assuming that you are required to change the name of the current branch in your project, then run the following command:

git branch -m new_branch_name

The following screenshot is a running example of the previous command changing the branch name from "branch1" to "branch2"

Renaming a different branch

Assuming that you want to rename another branch other than the current one in your project, then run the following command:

git branch -m old_branch_name new_branch_name

In the next example screenshot, "branch3" is renamed to "branch4" while the current branch is "branch2"

Renaming a remote branch

Assuming that you want to rename a branch that exists on the remote repository (for example GitHub), then you need to run the following command:

git push origin :old_remote_branch_name new_local_branch_name

The following screenshot shows that running the previous command could replace the remote branch "branch4" by the local branch "branch2" which means this operation is actually replacing branches rather than renaming.

How to change the current Git branch

This is a simple scenario where you only need to move from the current branch to another one.

Assuming that you are currently at branch "branch2" and you want to move to another existing local branch "branch4", then running the following command will achieve this:

git checkout branch4

If you want to move to another new branch that does not exist yet and you want to create it, then this can be done in two ways, the long way and the short way.

The long way will simply create the branch in a step and move to that created branch in another step as follows:

git branch branch5

The previous command will create a new branch called "branch5". Then moving to that branch will be as simple as:

However, the following shorthand command can do the previous two steps in only one, as follows:

git checkout -b branch5

That will create a new branch called "branch5" and move to it in one step.

Switching between branches on Visual studio

If you do not use Visual Studio as an IDE then you may need to skip this section.

Visual Studio 2017 provides a useful integration with Git where you can easily switch between branches with only one click.

On Visual Studio, please follow the next steps to change your current branch:

Open Team Explorer window.
Click Branches.
Right-click the branch you want to switch to and click "Checkout" as shown in the next screenshot.

How to delete Git branches

This scenario contains two obvious use cases, which are removing a local Git branch and deleting a remote one.

Deleting a local branch

To delete a local branch, make sure that this branch is not currently checked out.

Git will not allow you to delete a checked out branch which makes sense.

To delete a Git branch, run the following command:

git branch -d branch5

In the previous command, the local branch "branch5" will be deleted.

The following screenshot shows 2 attempts of deleting a local branch.

A failed attempt where the same checked out branch was being deleted, and a succeeded attempt where a different branch (branch4) was checked out while we were trying to delete "branch5".

Deleting a remote branch

Removing a remote branch is straightforward, simply run the following command:

git push origin --delete branch4

The previous command will delete the remote branch "branch4". You can also delete remote Git branches directly on GitHub as shown in the following screenshot:

Summary: Managing Git branches

Managing your Git branches by renaming, changing or deleting them is extremely easy and straightforward using any tool including Git bash commands.

As shown in this post, any operation can be done running only one command and the commands are self-explanatory.

Did you find this helpful?