Pick a username during account creation

When you sign up for GitHub, you choose your username on the same page where you enter your email and password. GitHub checks when ready whether the name is taken. If it is, you'll see a red X and a message telling you it's unavailable — then you pick a different one and check again. This happens before you confirm your email, so you can experiment with options without committing to anything.

Your username becomes part of your GitHub web address — for example, github.com/yourname — so pick something you won't mind typing and sharing. You can change it later, but doing it right the first time saves you from updating links in your projects and telling people your new address.

Key Takeaways

  • You create your GitHub username during the initial sign-up process, on the same form where you enter your email and password.
  • GitHub tells you when ready whether a username is available, so you can try different options before you finish signing up.
  • Usernames can contain letters, numbers, and hyphens, but cannot start or end with a hyphen.
  • You can change your username later from your account settings, though doing so changes your profile URL and may break links in your projects.

What characters and length are allowed

GitHub usernames can be 1 to 39 characters long and can include letters (a–z, A–Z), numbers (0–9), and hyphens (-). You cannot use spaces, underscores, or special characters like @, #, or $. The username cannot start or end with a hyphen — so "my-name" works, but "-myname" or "myname-" will not.

Usernames are not case-sensitive, which means GitHub treats "MyName" and "myname" as the same account. If you create an account with "MyName", you can log in with "myname" and your profile URL will display however you typed it during sign-up, but the system does not distinguish between them.

How to check if a username is taken

During sign-up, GitHub shows you whether your choice is available the moment you type it. If the name is taken, the field displays a red X and tells you so. You do not need to finish creating your account to test different options — just clear the field and try another name.

If you want to check a username before you start the sign-up process, you can visit github.com/username in your browser. If the account exists, you'll see that person's profile. If it does not exist, GitHub shows a 404 page saying the user was not found. This is a quick way to scout names without opening the sign-up form.

Why you might want to change your username later

GitHub lets you change your username from your account settings after you've created your account. When you do, your old username becomes available for someone else to claim, and your profile URL changes to the new name. Any links you've shared — in project documentation, on your resume, in social media — will no longer point to your profile.

Repositories you own stay with you and remain accessible, but their URLs change too. If someone has bookmarked or linked to your old profile or repositories, those links will break. For this reason, it's worth thinking through your username choice before you sign up, even though you can change it later.

Tips for choosing a username you'll keep

Pick something professional if you plan to share your GitHub profile with employers or collaborators. A username like "john-smith" or "jsmith-dev" is clearer than "xXcoder420Xx" or random numbers. Keep it short enough that it's straightforward to type and remember — longer names are harder to share verbally and more prone to typos when someone tries to find you.

Avoid usernames tied to temporary interests, inside jokes, or numbers that might feel dated later. If you're unsure, a variation of your real name is usually the safest choice. You can always add personality to your profile bio and project descriptions instead.

What happens after you create your username

Once you finish sign-up and confirm your email, your username is live and your profile is created. You can start creating repositories, following other users, and contributing to projects right away. Your username appears on every commit you make, every comment you post, and every repository you create — so it becomes part of your public presence on the platform.

If you later decide the username does not fit, you can change it in your account settings under "Change username". GitHub will warn you that the change affects your profile URL and any links to your repositories, and you'll need to confirm the new name. The change takes effect when ready.

Frequently Asked Questions

Can I use my email address as my GitHub username?

No. GitHub usernames cannot contain the @ symbol or a period followed by letters (like .com), so you cannot use a full email address. You can use the part before the @ sign if it meets the character rules — for example, if your email is john.smith@example.com, you could use "johnsmith" or "john-smith" as your username.

What if the username I want is taken?

Try adding a number, a hyphen, or a short descriptor to make it unique — for example, "john-smith-dev" or "johnsmith2". You can also check if the account is active by visiting its profile; if the account exists but has no activity and no repositories, the person may have abandoned it, but GitHub does not release inactive usernames for reuse.

Can I have multiple usernames on GitHub?

No. One email address creates one GitHub account with one username. If you need a separate account for a different purpose, you'll need a different email address. You can then log in to either account by switching between them in your browser settings.

Does my username have to match my real name?

No. Your username can be anything that follows GitHub's character rules. Many developers use a handle or pseudonym. Your real name goes in your profile bio if you want people to know it, and you can change that information anytime without changing your username.