Skip to main content

Username reference

Find information about changing your GitHub username.

Changing your username

The following list contains limitations and considerations when changing your GitHub username. For the GitHub username policy, see GitHub 用户名政策.

Limitations of username changes

如果帐户命名空间包含的公共存储库包含 GitHub Marketplace 上列出的操作,或这些公共存储库在重命名帐户前一周内超过 100 次克隆或超过 100 次使用 GitHub Actions,则在重命名帐户时,GitHub 将永久停用旧所有者名称和存储库名称组合 (OLD-OWNER/REPOSITORY-NAME)。 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."

如果帐户命名空间包含存储在 GitHub Packages 注册表中的任何包或容器映像,则 GitHub 会将包和容器映像传输到新的命名空间。 重命名帐户可能会中断依赖于这些包的项目。如果命名空间包含任何下载量超过 5,000 次的公共容器映像,则在重命名帐户时,这些容器映像的完整旧名称 (OLD-NAMESPACE/IMAGE-NAME) 将永久停用,以确保将来不能重复使用该容器映像名称。

Repository redirects after username change

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

Redirects for changed usernames

GitHub cannot set up redirects for:

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

Git commits after a username change

After a username change, verified commits signed using the previous GitHub-provided noreply email address will lose their "Verified" status.

When verifying a signature, GitHub 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 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.

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-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.