Rename a local Git branch

David Y.
jump to solution

The Problem

How can I rename a branch in my local Git repository?

The Solution

You can use git branch’s -m/--move flag to rename a branch in our local repository.

To rename the current (i.e. checked out) branch:

git branch -m new-branch-name

To rename a specific branch that may not be checked out:

git branch -m old-branch-name new-branch-name

To propagate this change to a remote, you can use git push to push the new branch and delete the old branch, as below:

git push origin -u new-branch-name
git push origin --delete old-branch-name

If you’re using Windows and would like to change only the capitalization in the branch name, use -M instead of -m to avoid an error.

git branch -M my-branch MY-BRANCH
Change the URI for a Git remote
David Y.
Check out a remote branch in Git
David Y.
List all files in a Git commit
David Y.

Considered "not bad" by 4 million developers and more than 150,000 organizations worldwide, Sentry provides code-level observability to many of the world's best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

Sentry