How To Delete a Branch in GitHub: Local and Remote Explained

Deleting a branch in GitHub sounds simple, but there are actually a few different ways to do it depending on where the branch lives and how you work with Git. Understanding those differences helps you clean up your repositories safely without breaking anything important.

This guide walks through:

• What a branch is and why you might delete one
• How to delete branches in GitHub’s web interface
• How to delete branches using Git on your computer (local and remote)
• Key variables that change the exact steps you should take
• How different types of users typically handle branch deletion

By the end, you’ll know how it works and which factors matter, but you’ll still need to match the approach to your own workflow and comfort level.

What Is a Branch in GitHub, Really?

In Git and GitHub, a branch is simply a separate line of development. You can think of it as:

• Main branch (often called main or master): your primary, stable codebase
• Feature branches (like feature/login-page): experiments, new features, bug fixes, or drafts

Branches let multiple people (or just you) work on different things at the same time without interfering with each other.

Why delete a branch?

Common reasons:

• You merged a pull request, and the feature branch is no longer needed
• You abandoned an experiment or idea
• You want to tidy up and avoid a long list of stale branches
• You’re enforcing a branch naming or workflow policy (for example, one branch per feature)

Deleting a branch does not delete the commits that are already merged into another branch. If the work was merged, the history remains in the target branch, even after you delete the original feature branch.

The main risk is deleting a branch that:

• Has unmerged work
• Is still used by others
• Is the default branch (GitHub normally blocks this)

Deleting a Branch on GitHub (Web Interface)

If you mostly use GitHub through your browser, you can delete branches directly in the web UI.

1. Delete a branch from a merged pull request

When you merge a pull request (PR), GitHub often suggests deleting the branch.

1. Go to the Pull request that was merged.
2. After merge, look for a “Delete branch” button near the bottom of the PR page.
3. Click Delete branch.

This deletes the remote branch on GitHub (not your local copy, if you have one).

2. Delete a branch from the Branches page

You can also manage branches from the repository’s Branches list:

1. Go to your repository on GitHub.

2. Click the “Branches” link (usually near the top, next to “Code”, “Issues”, “Pull requests”).

3. You’ll see:

   • Active branches
   • Stale branches
   • Information about whether they’re ahead/behind the default branch

4. Find the branch you want to delete.

5. Click the trash can icon or “Delete” button next to that branch.

6. Confirm if GitHub asks.

Notes:

• GitHub won’t let you delete the default branch from the UI. You have to change the default branch first if you truly intend to remove it.
• If a branch has unmerged commits, GitHub shows a warning. You can still delete it, but then those changes are only retrievable from the commit history, not an active branch.

Deleting a Local Branch Using Git (On Your Computer)

If you have the repository cloned on your computer, you’ll often want to delete the local copy of a branch as well.

Check your current branch

First, make sure you are not currently on the branch you want to delete.