Rename a local Git branch

David Y.

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

Loved by over 4 million developers and more than 90,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.

Share on Twitter
Bookmark this page
Ask a questionJoin the discussion

Related Answers

A better experience for your users. An easier life for your developers.

© 2024 • Sentry is a registered Trademark
of Functional Software, Inc.