Delete the local reference to a remote branch in Git

Follow a few simple steps to keep your Git repository tidy.
Register or Login to like
A diagram of a branching process

After you merge a GitLab or GitHub pull request, you usually delete the topic branch in the remote repository to maintain repository hygiene. However, this action deletes the topic branch only in the remote repository. Your local Git repository also benefits from routine cleanup.

To synchronize the information in your local repository with the remote repository, you can execute the git prune command to delete the local reference to a remote branch in your local repository.

Follow these three simple steps:

1. Checkout the central branch of your repository (such as main or master).

$ git checkout <central_branch_name>

2. List all the remote and local branches.

$ git branch -a

Example output:

* master

In this example, test-branch is the name of the topic branch that you deleted in the remote repository.

3. Delete the local reference to the remote branch.

First, list all the branches that you can delete or prune on your local repository:

$ git remote prune origin --dry-run

Example output:

Pruning origin
* [would prune] origin/test-branch

Next, prune the local reference to the remote branch:

$ git remote prune origin

Example output:

Pruning origin
* [pruned] origin/test-branch

That's it!

Maintaining your Git repository

Keeping your Git repository tidy may not seem urgent at first, but the more a repository grows, the more important it becomes to prune unnecessary data. Don't slow yourself down by forcing yourself to sift through data you no longer need.

Regularly deleting local references to remote branches is a good practice for maintaining a usable Git repository.

I am a Technical writer with Red Hat since Mar 2020. I write for software-defined storage products which include OpenShift Data Foundation, OpenShift Container Storage, Red Hat Gluster Storage, and Red Hat Hyperconverged Infrastructure for Virtualization.
Creative Commons LicenseThis work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.