how to delete a git branch

Deleting Git branches is common practice after you have merged a branch into your codebase. You can delete a Git branch on your local machine using the git branch -d flag. The git push origin –delete command removes a branch from a remote repository.

form-submission

Find Your Bootcamp Match

Career Karma matches you with top tech bootcamps
Get exclusive scholarships and prep courses

form-submission

Find Your Bootcamp Match

Career Karma matches you with top tech bootcamps
Get exclusive scholarships and prep courses

Branching lets you create independent versions of a project you can edit without affecting the main version of the project. When you are finished with a branch, you should delete it. This will help to keep your codebase clean.

There are two approaches you can use to delete a branch in Git. Which one you use will depend on whether the branch you are deleting is located on your local machine or in a remote repository.

This tutorial will discuss, with reference to examples, how to delete remote and local branches in Git. By the end of reading this tutorial, you'll be an expert at deleting local and remote branches.

Git Branching

Branching is an essential aspect of version control systems like Git. In Git, branches allow you to create a new version of an existing project. You can make changes to the new branch without affecting the original version of the project.

For instance, you could create a branch so you can work on adding a feature to the project. You could create another branch that stores the code for a bug fix you are working on.

Branching allows you to make changes to a codebase without changing the main version of the code until you are ready. If you're interested in learning more about Git branches, read our beginner's guide to the git branch command.

Delete Branch in Git

You may decide to delete a branch for a number of reasons. Perhaps you're done working on the branch and you have integrated the changes you have made into the main version of your project. Therefore, you no longer need the branch.

81% of participants stated they felt more confident about their tech job prospects after attending a bootcamp. Get matched to a bootcamp today.

The average bootcamp grad spent less than six months in career transition, from starting a bootcamp to finding their first job.

Git Delete Local Branch

You can delete a Git branch from your local machine using the git branch -d command. The -d flag denotes that you want to delete a branch.

Suppose we have a local branch called fix-issue49 that we recently merged with the main version of our project. This branch contains a bug fix we were working on. Since we no longer need this local branch, we are ready to delete it.

It is not possible to delete a branch that you are currently viewing. Before deleting a local branch, you must first navigate to any other branch aside from the one you want to delete.

So, because we want to delete fix-issue49, we first need to navigate to another branch. To do so, we can use the git checkout command.

The following command allows us to navigate to the master branch in our local repository:

Now that we're on the master branch, we can delete the local fix-issue49 branch. We can do so using the following code:

git branch -d fix-issue49

The -d flag indicates that we want to delete our branch. fix-issue49 is the name of the branch we want to delete. When we run this command, Git deletes the local branch fix-issue49.

form-submission

Find Your Bootcamp Match

Career Karma matches you with top tech bootcamps
Get exclusive scholarships and prep courses

If Git encounters any problems in deleting our branch, the deletion operation will stop.

You can use the -D flag (note the capital letter) to force delete a local branch. The -D flag will delete a branch regardless of whether you merged it to another branch in your codebase.

Use the -D flag with caution as the flag immediately deletes branches. Unless you are fully confident that you want to delete a branch, it is best to use the -d flag.

Git Delete Remote Branch

To delete a remote branch in Git, you can use the command. This command instructs Git to push your local changes to the remote repository. In this process, Git deletes the branch you specify that you want to delete.

Suppose we want to delete a branch called fix-issue12. This branch is stored in our remote repository. Our remote origin refers to our remote repository. We can delete the fix-issue12 branch by using the following command:

git push origin --delete fix-issue12

The above command deletes the remote fix-issue12 branch.

After running this command, we should run a fetch command to retrieve an up-to-date copy of all the branches stored on our remote repository. This will allow us to see, on our local machine, the changes made to our remote repository.

The following is what we would type into the program to fetch the branches on our remote repository:

When you run this command, your local Git repository will fetch a copy of the remote repository and its branches. The -p flag instructs Git to delete any local branches that no longer exist on your remote repository.

To learn more about the git fetch command, read our guide on git fetch.

Conclusion

Developers usually delete branches after they merge them with others in the repository.

Venus profile photo

"Career Karma entered my life when I needed it most and quickly helped me match with a bootcamp. Two months after graduating, I found my dream job that aligned with my values and goals in life!"

Venus, Software Engineer at Rockbot

The git branch -d command allows you to delete a local branch. The command allows you to delete a remote branch.

In this tutorial, we discussed how to use these two commands to delete branches in Git. Now you're equipped with the knowledge you need to start deleting branches like a Git pro!