Sentry Answers>Git>

Rename a local Git branch

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:

Click to Copy
git branch -m new-branch-name

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

Click to Copy
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:

Click to Copy
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.

Click to Copy
git branch -M my-branch MY-BRANCH
  • Syntax.fmListen to the Syntax Podcast
  • ResourcesWhat is Distributed Tracing
  • Syntax.fm logo
    Listen to the Syntax Podcast

    Tasty treats for web developers brought to you by Sentry. Get tips and tricks from Wes Bos and Scott Tolinski.

    SEE EPISODES

Considered “not bad” by 4 million developers and more than 100,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.

learn more about sentryjoin our discord
© 2025 • Sentry is a registered Trademark of Functional Software, Inc.