Sentry Answers>Git>

Rename a local Git branch

Rename a local Git branch

David Y.

The ProblemJump To Solution

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
  • ResourcesWhat is Distributed Tracing
  • Syntax.fm logo
    Listen to the Syntax Podcast

    Tasty Treats for Web Developers brought to you by Sentry. Web development tips and tricks hosted by Wes Bos and Scott Tolinski

    Listen to Syntax

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.

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