When you change your GitHub username, most references to your repositories under the old username automatically change to the new username. However, some links to your profile won't automatically redirect. Commits made with your username@users.noreply.github.com email address will no longer be associated with your account. Commits made using your ID+username@users.noreply.github.com email address will continue to be associated with your account.

Repository references

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

  • Web links to your existing repositories will continue to work. This can take a few minutes to complete after you make the change.
  • Command line pushes from your local repository clones to the old remote tracking URLs will continue to work.

After changing your username, your old username becomes available for anyone else to claim. If the new owner of your old username creates a repository with the same name as your repository, that will override the redirect entry and your redirect will stop working. Because of this possibility, we recommend you update all existing remote repository URLs after changing your username. For more information, see "Changing a remote's URL."

GitHub cannot set up redirects for:

  • @mentions using your old username
  • Links to Gists with your old username

Links to your previous profile page

After changing your username, links to your previous profile page, such as https://github.com/previoususername, will return a 404 error. We recommend updating any links to your GitHub account from elsewhere, such as your LinkedIn or Twitter profile.

Your Git commits

Git commits that were associated with your GitHub-provided noreply email address won't be attributed to your new username and won't appear in your contributions graph. If your Git commits are associated with another email address you've added to your GitHub account, including the ID-based GitHub-provided noreply email address, they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "Setting your commit email address on GitHub."

Further reading