Skip to content

Commit 46f0121

Browse files
jc-clarkCopilotam-stead
authored
[EDI] Update "Changing your GitHub username" (#57489)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com>
1 parent aa36330 commit 46f0121

File tree

8 files changed

+163
-117
lines changed

8 files changed

+163
-117
lines changed

content/account-and-profile/concepts/changing-your-github-username.md

Lines changed: 0 additions & 115 deletions
This file was deleted.

content/account-and-profile/concepts/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,9 @@ children:
1515
- /contributions-visible-on-your-profile
1616
- /about-your-organizations-profile
1717
- /about-organization-membership
18-
- /changing-your-github-username
18+
- /username-changes
1919
- /email-addresses
2020
- /scheduled-reminders
2121
- /personal-repository-access-and-collaboration
2222
---
23+
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Username changes
3+
intro: You can change the username for your {% data variables.product.github %} account {% ifversion ghes %} if your instance uses built-in authentication{% endif %}.
4+
redirect_from:
5+
- /articles/how-to-change-your-username
6+
- /articles/changing-your-github-user-name
7+
- /articles/renaming-a-user
8+
- /articles/what-happens-when-i-change-my-username
9+
- /articles/changing-your-github-username
10+
- /github/setting-up-and-managing-your-github-user-account/changing-your-github-username
11+
- /github/setting-up-and-managing-your-github-user-account/managing-user-account-settings/changing-your-github-username
12+
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/changing-your-github-username
13+
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username
14+
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/changing-your-github-username
15+
- /account-and-profile/concepts/changing-your-github-username
16+
versions:
17+
fpt: '*'
18+
ghes: '*'
19+
ghec: '*'
20+
topics:
21+
- Accounts
22+
- Usernames
23+
shortTitle: Username changes
24+
contentType: concepts
25+
---
26+
27+
## About username changes
28+
29+
You can change your username to another username that is not currently in use.{% ifversion fpt or ghec %} 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.
30+
31+
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.
32+
33+
## Username trademarks
34+
35+
If you hold a trademark for the username, you can find more information about making a trademark complaint on our [Trademark Policy](/free-pro-team@latest/site-policy/content-removal-policies/github-trademark-policy) page.
36+
37+
If you do not hold a trademark for the name, you can choose another username or keep your current username. {% data variables.contact.github_support %} cannot release the unavailable username for you.{% endif %}
38+
39+
## Repository references
40+
41+
After you change your username, {% data variables.product.github %} will automatically redirect references to your repositories.
42+
43+
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 [AUTOTITLE](/get-started/git-basics/managing-remote-repositories).
44+
45+
## Links to your previous profile page
46+
47+
After changing your username, links to your previous profile page, such as `https://{% data variables.product.product_url %}/previoususername`, will return a 404 error. We recommend updating any links to your profile from elsewhere{% ifversion fpt or ghec %}, such as your LinkedIn or Twitter profile{% endif %}.
48+
49+
## Accounts logged in on {% data variables.product.prodname_mobile %}
50+
51+
Accounts logged in on the {% data variables.product.prodname_mobile %} app may continue to display your original username until you log out. To ensure your updated username is displayed, we recommend you sign out and back in to your account on each mobile device.
52+
53+
## Your Git commits
54+
55+
If your Git commits are associated with another email address you've added to your {% data variables.product.github %} account, they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. However, some commits using {% data variables.product.github %}-provided email addresses may be affected. For details, see [AUTOTITLE](/account-and-profile/reference/username-reference#git-commits-after-a-username-change).
56+
57+
## Your gists
58+
59+
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.
60+
61+
## CODEOWNERS files
62+
63+
After changing your username, CODEOWNERS files that include your old username will need to be manually updated. When you view the CODEOWNERS files on {% data variables.product.github %}, 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.
64+
65+
## Next steps
66+
67+
To change your username, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username).
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: Changing your username
3+
intro: 'Change your {% data variables.product.github %} username.'
4+
versions:
5+
fpt: '*'
6+
ghes: '*'
7+
ghec: '*'
8+
topics:
9+
- Accounts
10+
- Usernames
11+
shortTitle: Change username
12+
permissions: '{% ifversion ghec %}Users with personal accounts can change their username. Members of an {% data variables.enterprise.prodname_emu_enterprise %} cannot change their username.{% elsif ghes %}If your instance uses built-in authentication, you can change your username. If you sign in to {% data variables.location.product_location %} with LDAP credentials or single sign-on (SSO), only your local administrator can change your username.{% else %}Users with personal accounts can change their username.{% endif %}'
13+
---
14+
15+
## Prerequisites
16+
17+
Before changing your username, you should be aware of potential impacts on your account and activity. For more information, see [AUTOTITLE](/account-and-profile/concepts/username-changes).
18+
19+
## Changing your username
20+
21+
{% data reusables.user-settings.access_settings %}
22+
{% data reusables.user-settings.account_settings %}
23+
1. In the "Change username" section, click **Change username**.{% ifversion fpt or ghec %}
24+
1. Read the warnings about changing your username. If you still want to change your username, click **I understand, let's change my username**.
25+
1. Type a new username.
26+
1. 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.
27+
{% endif %}
28+
29+
## Next steps
30+
31+
For reference information and limitations, see [AUTOTITLE](/account-and-profile/reference/username-reference#changing-your-username).

content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ topics:
1111
children:
1212
- /managing-multiple-accounts
1313
- /merging-multiple-personal-accounts
14+
- /changing-your-username
1415
- /converting-a-user-into-an-organization
1516
- /unlinking-your-email-address-from-a-locked-account
1617
- /deleting-your-personal-account

content/account-and-profile/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ introLinks:
77
- /get-started/onboarding/getting-started-with-your-github-account
88
featuredLinks:
99
startHere:
10-
- /account-and-profile/concepts/changing-your-github-username
10+
- /account-and-profile/concepts/username-changes
1111
- /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme
1212
popular:
1313
- /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address

content/account-and-profile/reference/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,6 @@ children:
1414
- /types-of-emails-github-sends
1515
- /email-addresses-reference
1616
- /personal-account-reference
17+
- /username-reference
1718
---
1819

0 commit comments

Comments
 (0)