How to Delete a Local Branch in Git?

Git branches make it easier for developers to work on features, bug fixes, experiments, and releases without affecting the main codebase. However, repositories can accumulate old or completed branches over time. Removing these unused branches helps keep the local repository organized.

The git delete local branch operation is generally performed with the git branch -d command.

For example:

git branch -d feature-login

This deletes the local feature-login branch when Git determines that it has been safely merged.

What Does Deleting a Local Git Branch Mean?

A local Git branch is a reference to a particular line of development stored in your local repository.

When you delete a local branch, Git removes that branch reference from your local repository. The commits themselves may still exist through other branches or references.

For example:

main

|

+--- feature-login

|

+--- feature-search

After completing feature-login, you might remove it with:

git branch -d feature-login

The branch reference disappears from your local repository.

How to Delete a Local Branch in Git?

Before deleting a branch, switch to another branch. You cannot normally delete the branch that you currently have checked out.

First, view your branches:

git branch

Example:

* feature-login
  main
  feature-search

Switch to main:

git switch main

Then delete the branch:

git branch -d feature-login

Older Git workflows can use:

git checkout main
git branch -d feature-login

What is git branch -d?

The -d option performs a safe deletion.

git branch -d branch-name

For example:

git branch -d feature-payment

Git checks whether the branch has been merged into the current branch or another appropriate upstream relationship.

If the branch contains unmerged work, Git normally prevents the deletion.

This safety check helps avoid accidentally removing a branch containing changes you still need.

How to Force Delete a Local Branch?

Sometimes you intentionally want to delete an unmerged branch.

In that situation, use:

git branch -D branch-name

For example:

git branch -D experimental-feature

The uppercase -D is effectively a force-delete option.

git branch -d branch-name

How to Check Which Branch You Are On?

Before deleting a branch, check your current branch:

git branch --show-current

You can also run:

git status

For example:

On branch main

Once you’re on another branch, you can safely delete the completed local branch.

How to List Local Git Branches?

Use:

git branch

Example:

  main
* feature-dashboard
  feature-api
  bugfix-login

The * identifies the currently checked-out branch.

To show both local and remote branches:

git branch -a

Git Delete Local Branch vs Remote Branch

Deleting a local branch does not automatically delete the corresponding remote branch.

For example:

git branch -d feature-login

removes the local branch only.

If you also need to remove the remote branch, use:

git push origin --delete feature-login

These are separate operations.

git branch -d unfinished-feature

git branch -D unfinished-feature

git log unfinished-feature

git diff main...unfinished-feature

git branch -d feature-one
git branch -d feature-two
git branch -d bugfix-one

git branch -D feature-one feature-two bugfix-one

git switch main
git pull
git branch -d feature-login

import subprocess

branch = "feature-login"

result = subprocess.run(
    ["git", "branch", "-d", branch],
    capture_output=True,
    text=True
)

print(result.stdout)
print(result.stderr)

if result.returncode == 0:
    print("Branch deleted successfully.")
else:
    print("Branch could not be deleted.")

git branch -d feature-login

git switch main

git push origin --delete branch-name

git status

git branch -d branch-name

git switch main
git branch -d feature-login

git branch -D feature-login