Summarize this article with:
Branches pile up fast.
After a few sprints, your repository looks like a graveyard of abandoned feature branches and failed experiments.
Knowing how to delete a branch in Git keeps your codebase clean and your team productive.
This guide walks you through removing both local and remote branches using terminal commands.
You’ll learn the safe deletion method, force deletion for unmerged work, and cleanup commands for stale tracking references.
Six steps. Two minutes. No leftover clutter.
How to Delete a Branch in Git
Deleting a branch in Git removes the pointer to a specific line of commits from your local or remote repository.
Developers need this when feature branches get merged, experiments fail, or old code paths clutter the project.
This guide covers 6 steps requiring about 2 minutes and basic terminal knowledge.
Prerequisites
Before running any branch deletion commands, make sure you have:
- Git version 1.7.0 or later (run
git --versionto check) - Terminal or command line access
- Basic understanding of Git branches and checkout
- Write permissions on the repository (for remote deletion)
Time estimate: 1-2 minutes for local branches, 2-3 minutes including remote cleanup.
Step One: How Do You Check Which Branch You Are Currently On?
Run git branch in your terminal to display all local branches; the current branch shows an asterisk () next to its name.
Action
- Open terminal in your project directory
- Run:
git branch - Look for the
symbol indicating your current branch
Expected Output
“ feature-login
- main
bugfix-header `
The asterisk marks main as the active branch.
Purpose
Git prevents deletion of the currently checked-out branch.
Knowing your position avoids the “cannot delete branch” error.
Step Two: How Do You Switch Away From the Branch You Want to Delete?
Use git checkout main or git switch main to move to a different branch before attempting deletion.
Action
- Choose a target branch: typically main
ormaster
- Run: git checkout main
- Confirm the switch with git status
Alternative Command
Git 2.23+ users can run git switch main instead.
Both commands accomplish the same result.
Expected Output
` Switched to branch 'main' Your branch is up to date with 'origin/main'. `
Purpose
You cannot delete a branch while standing on it.
Switching first is mandatory for successful local branch removal.
Step Three: How Do You Delete a Local Git Branch?
Run git branch -d branch-name to safely remove a local branch that has been fully merged into your current branch.
Action
- Identify the branch name you want to remove
- Run: git branch -d feature-login
- Read the confirmation message showing the deleted branch and its last commit hash
Command Syntax
` git branch -d <branch-name> git branch --delete <branch-name> `
Both forms work identically.
Expected Output
` Deleted branch feature-login (was 4a2b3c1). `
The hash 4a2b3c1 references the branch's final commit.
Purpose
The -d flag performs a safe deletion.
Git checks if merged changes exist before removing; unmerged branches trigger an error preventing accidental data loss.
Step Four: How Do You Force Delete an Unmerged Local Branch?
Run git branch -D branch-name to forcefully remove a local branch containing unmerged commits without safety checks.
Action
- Confirm you want to lose unmerged work permanently
- Run: git branch -D feature-experiment
- Note the deletion message; no recovery without reflog
Command Syntax
` git branch -D <branch-name> `
Capital -D bypasses the merge check.
When to Use Force Delete
- Abandoned experiments with no value
- Branches created by mistake
- Test branches after failed prototypes
Purpose
The -D flag combines –delete and –force.
Use carefully; commits on force-deleted branches become orphaned.
Step Five: How Do You Delete a Remote Git Branch?
Run git push origin –delete branch-name to remove a branch from GitHub, GitLab, Bitbucket, or any remote repository.
Action
- Identify the remote name (usually origin)
- Run: git push origin –delete feature-login
- Wait for server confirmation
Command Syntax
` git push <remote> --delete <branch-name> git push origin :<branch-name> `
Both syntaxes work; the first reads clearer.
Expected Output
` To github.com:username/repo.git
- [deleted] feature-login
`
Purpose
Remote branch deletion keeps your shared repository clean.
Team members see fewer stale branches when browsing the project.
Step Six: How Do You Clean Up Stale Remote-Tracking References?
Run git fetch –prune to remove local references pointing to branches that no longer exist on the remote server.
Action
- Run: git fetch –prune
- Or use shorthand: git fetch -p
- Check remaining branches with git branch -a
What Gets Removed
Stale remotes/origin/branch-name entries disappear.
Your local branches stay untouched by git prune.
Automatic Pruning
` git config --global fetch.prune true `
This setting runs prune automatically with every git fetch.
Verification
Confirm your branch deletions worked by listing all remaining branches.
Commands to Verify
` git branch # local branches only
git branch -r # remote-tracking branches only
git branch -a # all branches
`
What to Look For
The deleted branch should not appear in any list.
If the remote branch still shows, run git fetch –prune again.
Troubleshooting
Issue: Cannot Delete Branch Currently Checked Out
Error: error: Cannot delete branch ‘feature’ checked out at ‘/path/repo’
Solution: Run git checkout main first, then retry deletion.
Issue: Branch Has Unmerged Changes
Error: error: The branch ‘feature’ is not fully merged
Solution: Merge the branch first, or use git branch -D to force delete.
Issue: Remote Branch Still Appears After Deletion
Error: Branch shows in git branch -r output after remote deletion.
Solution: Run git fetch –prune to sync local tracking references.
Issue: Permission Denied on Remote Deletion
Error: remote: Permission denied or authentication failure.
Solution: Check repository access rights; you need write permissions on the remote.
Alternative Methods
Method A: Command Line (This Guide)
- Time: 1-2 minutes
- Complexity: Basic terminal knowledge
- Best for: Daily workflow, scripting, CI/CD pipelines
Method B: GitHub Web Interface
- Time: 30 seconds
- Complexity: Beginner-friendly
- Best for: Visual confirmation, deleting branches in GitHub after pull requests
Choose command line for batch operations or automation.
Use the web interface for quick one-off deletions with visual feedback.
Related Processes
- How to create a new branch in Git
- How to merge branches in GitHub
- How to rename a branch in Git
- How to switch branches in Git
- How to revert a commit in Git
FAQ on How To Delete A Branch In Git
What is the difference between git branch -d and -D?
The -d flag performs a safe delete, checking if the branch has been merged first.
The -D flag forces deletion regardless of merge status, permanently removing unmerged commits without warning.
Can I recover a deleted Git branch?
Yes, within a limited window.
Run git reflog to find the deleted branch's last commit hash, then run git checkout -b branch-name hash to restore it before garbage collection runs.
Does deleting a local branch affect the remote branch?
No. Local and remote branches are separate references.
Deleting locally with git branch -d leaves the remote untouched. You must run git push origin –delete separately to remove the remote branch.
Why can’t I delete the branch I’m currently on?
Git prevents deleting your current working branch to avoid orphaning your checkout state.
Switch to another branch like main first using git checkout main, then delete.
How do I delete multiple branches at once?
List branch names after the flag: git branch -d branch1 branch2 branch3.
For pattern-based deletion, use: git branch | grep “feature” | xargs git branch -d to remove all matching branches.
What happens to commits on a deleted branch?
Commits become orphaned if not merged elsewhere.
Git’s garbage collection removes orphaned commits after approximately 30 days. Until then, git log with reflog can still access them.
How do I delete a branch that has already been merged?
Use the standard git branch -d branch-name command.
Git automatically verifies the merge status. Merged branches delete without errors; this is the recommended cleanup method after completing pull request workflows.
Can I delete the main or master branch?
Technically yes, but don’t.
Git allows it if you’re on another branch. Remote repositories often protect main through branch protection rules. Deleting your default branch breaks most version control workflows.
How do I see which branches are safe to delete?
Run git branch –merged to list branches already merged into your current branch.
These are safe deletion candidates. Run git branch –no-merged to see branches with unmerged work.
Do deleted branches show up in Git history?
No. Branches are just pointers, not recorded in commit history.
Once deleted, no trace remains unless commits were merged. The reflog temporarily keeps references for recovery purposes.
Conclusion
Knowing how to delete a branch in Git is a core skill for any developer working with version control.
Use git branch -d for safe local deletion. Use git branch -D when you need to force remove unmerged work.
Remote branches require git push origin –delete.
Run git fetch –prune` regularly to clean stale tracking references.
These commands take seconds but keep your repository organized for months.
Clean branch management supports better code review workflows and smoother deployment pipelines.
Your team will thank you for the tidy remote history.
Start deleting those old feature branches today.
Many of his resources are available on various design marketplaces and for free on Codepen.
Over the years, he's worked with a range of clients and contributed to design publications like Design Your Way, Designmodo, WebDesignerDepot, WPDean, and Speckyboy, and Slider Revolution among others.
- Feature-Driven Development vs Agile: Key Differences - March 12, 2026
- Agile vs DevOps: How They Work Together - March 11, 2026
- Ranking The Best Mapping Software by Features - March 11, 2026
