Skip to main content

Changing your GitHub username

You can change the username for your account on GitHub.com.

Note: Members of an entreprise avec utilisateurs managés cannot change usernames. Your enterprise's IdP administrator controls your username for GitHub Enterprise Cloud. For more information, see "À propos d’Enterprise Managed Users."

About username changes

You can change your username to another username that is not currently in use. If the username you want is not available, consider other names or unique variations. Using a number, hyphen, or an alternative spelling might help you find a similar username that's still available.

If you hold a trademark for the username, you can find more information about making a trademark complaint on our Trademark Policy page.

If you do not hold a trademark for the name, you can choose another username or keep your current username. Support GitHub cannot release the unavailable username for you. For more information, see "Changing your username."

After changing your username, your old username becomes available for anyone else to claim. 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.

GitHub Enterprise Cloud cannot set up redirects for:

  • @mentions using your old username
  • Links to gists that include your old username

If you're a member of an entreprise avec utilisateurs managés, you cannot make changes to your username. Pour plus d’informations, consultez « Types de comptes GitHub ».

Si l’espace de noms du compte inclut des dépôts publics qui contiennent une action listée sur GitHub Marketplace ou qui comptabilisent plus de 100 clones ou plus de 100 utilisations de GitHub Actions au cours de la semaine précédant le changement de nom de votre compte, GitHub met définitivement hors service l’ancienne combinaison nom de propriétaire et nom de dépôt (OLD-OWNER/REPOSITORY-NAME) quand vous renommez votre compte. If you try to create a repository using a retired owner name and repository name combination, you will see the error: "The repository <REPOSITORY_NAME> has been retired and cannot be reused."

Si l’espace de noms du compte inclut des packages ou des images conteneur stockées dans un registre GitHub Packages, GitHub transfère les packages et les images conteneur vers le nouvel espace de noms. En renommant votre compte, vous pouvez perturber des projets qui dépendent de ces packages. Si l’espace de noms inclut des images conteneur qui sont publiques et ont plus de 5 000 téléchargements, l’ancien nom complet de ces images conteneur (OLD-NAMESPACE/IMAGE-NAME) est définitivement abandonné lorsque vous renommez le compte pour garantir que le nom de l’image conteneur ne peut pas être réutilisé à l’avenir.

Repository references

After you change your username, GitHub Enterprise Cloud 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.

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 "Création de dépôt distants."

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 account on GitHub.com from elsewhere, such as your LinkedIn or Twitter profile.

Your Git commits

If your Git commits are associated with another email address you've added to your GitHub account, 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 "Définition de votre adresse e-mail de commit" and "Ajout d’une adresse e-mail à votre compte GitHub."

If you've been using a GitHub-provided private commit email address, whether or not your commit history will be retained after an account rename depends on the format of the email address. Git commits that are associated with your GitHub Enterprise Cloud-provided noreply email address won't be attributed to your new username and won't appear in your contributions graph, unless your noreply email address is in the form of ID+USERNAME@users.noreply.github.com. Older versions of the noreply email address that do not contain a numeric ID will not be associated with your GitHub account after changing your username.

Warnings:

  • After a username change, verified commits signed using the previous GitHub Enterprise Cloud-provided noreply email address will lose their "Verified" status.
  • When verifying a signature, GitHub Enterprise Cloud checks that the email address of the committer or tagger exactly matches one of the email addresses associated with the GPG key's identities. Additionally, GitHub Enterprise Cloud confirms that the email address is verified and linked to the user's account. This ensures that the key belongs to you and that you created the commit or tag. Because the username of the noreply email address changes, these commits can no longer be verified.

Your gists

After changing your username, the URLs to any public or secret gists will also change and previous links to these will return a 404 error. We recommend updating the links to these gists anywhere you may have shared them.

CODEOWNERS files

After changing your username, CODEOWNERS files that include your old username will need to be manually updated. When you view the CODEOWNERS files on GitHub.com, an error message is displayed if the file contains any unknown users, or users without write access. We recommend updating all relevant CODEOWNERS files with your new username. For more information, see "À propos des propriétaires de code."

Changing your username

  1. Dans le coin supérieur droit d’une page, cliquez sur votre photo de profil, puis sur Paramètres.

    Capture d’écran du menu du compte de GitHub montrant les options permettant aux utilisateurs d’afficher et de modifier leur profil, leur contenu et leurs paramètres. L’élément de menu « Paramètres » est présenté en orange foncé.

  2. Dans la barre latérale gauche, cliquez sur Compte.

  3. In the "Change username" section, click Change username.

  4. Read the warnings about changing your username. If you still want to change your username, click I understand, let's change my username.

  5. Type a new username.

  6. If the username you've chosen is available, click Change my username. If the username you've chosen is unavailable, you can try a different username or one of the suggestions you see.

Further reading