How to Change GitHub Username in 6 Easy Steps!

GitHub is a code hosting platform for version control and collaboration. It’s a great place to share your code with others and work on projects together. Your GitHub username is the unique name that identifies you on GitHub. If you’re not happy with your current username, you can change it! Here’s how to do it.

Table of Content

Things You Should Know To Change GitHub Username

  • You want to change your identifier on GitHub.
  • You want to change the URL identifier of your profile and your repositories.
  • You need to follow the steps carefully to be able to change your username on GitHub.

What Happens After Changing GitHub Username

Changing your GitHub username will affect all your files stored in the repository. This also will create a new path and directory referred to the new username.

1. Repository References

GitHub will automatically redirect references to your repositories after you change your username.

  • Web links to your existing repositories will remain active. After you make the change, this may take a few minutes to complete.
  • Command line pushes to the old remote tracking URLs from your local repository clones will continue to work.

If the new owner of your old username creates a repository with the same name as your repository, the redirect entry will be overwritten and your redirect will no longer work.

Because of this possibility, we recommend that after changing your username, you update all existing remote repository URLs. See “Managing Remote Repositories” for more information.

2. Links to your previous profile page

Links to your previous profile page, such as, will return a 404 error after you change your username. We recommend that you update any links to your account from other places, such as your LinkedIn or Twitter profiles.

See Also  How to Make a GitHub Repository Private

3. Your Git Commits

Git commits associated with your noreply email address provided by GitHub will not be attributed to your new username and will not appear in your contributions graph. If you’ve added another email address to your GitHub account, including the ID-based GitHub-provided no-reply email address, your Git commits will still be attributed to you and appear in your contributions graph after you change your username. See “Setting your commit email address” for more information on how to do so.

4. Your Gists

The URLs to any public or secret gists will change after you change your username, and previous links to these will return a 404 error. We recommend that you update any links to these gists that you may have shared.

How to Change GitHub Username

If you have any projects that are using your old username as a remote, you’ll need to update the URL. With that said, let’s get started!

  1. Click your profile photo in the upper-right corner of any page, then “Settings.”
  2. Click the “Gear/Setting” Account in the left sidebar.
  3. Click Change username in the “Change username” section.
  4. Read the cautionary notes about changing your username. If you want to keep your current username, click “I understand, let’s change my username.”
  5. Create a new username.
  6. Click “Change my username” if the username you’ve chosen is available. If the username you’ve chosen is not available, you can try another or one of the suggestions.


Your GitHub username is how you’re identified on the platform. If you’re not happy with yours, no worries! Changing it is a pretty straightforward process. Just keep in mind that changing your username will also change the URL of your profile and all your repositories, so make sure to update any remotes that are using your old username accordingly.

Share This Post

Newest Articles

How to Get a GitHub Access Token for Personal Access

No longer have access to your personal GitHub repository? You can use the GitHub Access Token to open it. Read the full guide here!

How to Make a GitHub Repository Private

Developers can now create a private GitHub repository in the free tier as of January 7, 2019. Read how to get the private repository feature on GitHub here!

3 Methods of How to Install Android SDK Repository

Android is one of the most used operating systems for software development. Read the full guide on how to get the Android SDK here!

How to Turn Off Android Developer Mode

Android Developer Options allows you to access hidden features. If you want to deactivate it, follow this simple guide to turn it off!

5 Simple Ways How to Get Cookie Clicker GitHub

How to get and use Cookie Clicker on GitHub? You can find the simple steps and cheats for Cookie Clicker in this article!

How to Integrate Jira with GitHub in 6 Easy Steps

If you use Jira for your work and need to integrate with another organization that uses GitHub, integration is what you require. Read the details here!