How to Rename a Branch in Git: A Complete Guide

Ever found yourself in a situation where you need to change the name of a Git branch but aren't sure how? Whether correcting a typo or improving clarity, learning How to Rename a Branch in Git is crucial. Git is an incredibly powerful tool, but it can be daunting if you're not familiar with all the commands and procedures.

In this blog, we’ll walk you through the entire process of renaming both local and remote Git branches. By the end of this blog, you'll not only know How to Rename a Branch in Git but also how to update your local and remote repositories seamlessly. So, let's dive in and master this essential Git skill!

Table of Contents

1) What is a Git Repository?

2) What is a Git Branch?

3) How to Rename a Git Branch?

4) How to Remove a Remote Git Branch?

5) Conclusion

What is a Git Repository?

A Git repository, or repo, is a storage space for project files and their version histories. It enables you to track changes, revert to previous states, and manage development branches. It acts as a logbook of your project's progress, aiding both solo and team-based development.

Repositories can be local, on your computer, or remote, on servers like GitHub, GitLab, or Bitbucket. Local repos support individual development and offline work, while remote repos facilitate collaboration and act as backups. This combination ensures efficient Project Management and seamless teamwork, making Git essential for modern Software Development.

What is a Git Branch?

In Git, a branch is an independent line of development that lets you diverge from the main codebase to work on new features, bug fixes, or experiments without impacting the main branch, typically called "main" or "master." Branches provide a way to isolate your work, ensuring that ongoing development does not interfere with the stable code.

Once the work on a branch is complete and tested, it is able to be remerged into the main branch, integrating the changes. This process helps maintain a clean and organised workflow, supporting efficient and collaborative development.

Unlock your potential with our Git & GitHub Fundamentals Course - join now and master GitHub!

How to Rename a Git Branch?

Renaming a Git branch can be essential for maintaining clarity and avoiding issues. Let’s explore how to rename both local and remote branches:

Rename a Local Git Branch

a) Select the Branch: In your command line, choose the Git branch you want to rename using “git checkout old-name". You’ll receive confirmation that you’ve switched to the correct branch (e.g., “Switched to branch ‘old-name’”).

b) Perform the Rename: Execute the actual rename with “git branch -m new-name".

Alternatively, you can rename the branch via the master branch:

a) Switch to Master: Use “git checkout master” to switch to the master branch.

b) Rename the Branch: Execute “git branch -m old-name new-name".

c) Verify: Confirm the successful rename by checking the branch status with “git branch –a".

Renaming a Remote Git Branch

There are two different ways to rename a remote branch in Git. Let’s explore them below:

Method 1

a) Local Branch Name: Ensure that the local branch has the correct new name (use “git branch –a”).

b) Delete the Old Branch: Remove the branch with the incorrect name from the remote repository using “git push origin --delete old-name".

c) Verify Deletion: Confirm that the old branch has been deleted properly. Learn How to Delete a Branch in Git and ensure that the removal was successful.

d) Add the Correctly Named Branch: Add the branch with the desired name using “git push origin -u new-name".

e) Reset Upstream Branch: Perform a reset of the upstream branch to apply the changes effectively.

Method 2

For a concise one-command option to rename a remote Git branch:

a) Use “git push origin :old-name new-name".

Updating A Local Clone After Branch Name Changes

When a branch name changes in the remote Git repository, updating your local clone is essential. Follow these steps to ensure synchronisation:

a) Fetch New Data: Use “git fetch ” to retrieve updates from the remote repository. This ensures both repositories have the latest content.

b) Review Changes: Run “git log -p –graph" to examine commits and compare between repositories (e.g., staging vs. production). Customise with flags like “--author="John Doe"” or “--since="last week"”.

c) Remove Local References: Delete local references to prevent merge errors. Execute “rm -rf .git/refs remotes//new_branch_name>”.

d) Update Tracking Info: Set tracking info for the renamed branch using “git remote set-head -a ”.

e) Checkout and Push: Locally, check out the renamed branch and push to origin: “git checkout && git push --set-upstream origin/”.

f) Validate Changes: Confirm success with “git status”. Review local files and related change sets.

g) Tag Versions: If needed, tag versions locally and remotely using “git tag -a -m "" && git push –tags”.

Kickstart your journey in App & Web Development Training -register today and thrive!

How to Remove a Remote Git Branch?

To remove a remote Git branch, follow these steps:

a) Delete the Remote Branch: Execute the following command to remove the remote branch:

b) Verify the Deletion: Confirm the removal by fetching updates from the remote repository:

Elevate your career with mobile app development skills- join our Mobile App Development Course now!

Conclusion

Knowing How to Rename a Branch in Git is crucial for maintaining project organisation and clarity. Whether correcting typos or aligning with conventions, this blog ensures you can manage branch renaming efficiently, both locally and remotely. Additionally, understanding Git Rebase can help streamline your commit history, making it easier to integrate changes cleanly. This prevents confusion and improves workflow. Master this skill to enhance your development process further.

Master UX/UI design essentials with our expert-led UI UX Design Course - register now to get started!