Pick a username you won't regret in five years

Your GitHub username is the address people use to find your work. It appears in every repository URL, every commit, every pull request. Unlike an email address, you cannot change it without losing your contribution history and breaking links across the internet. Choose something professional enough that you would not mind it on a resume, short enough to type without mistakes, and stable enough that you will still want it attached to your name a decade from now.

The best usernames are your actual name or a clear variation of it. If your name is taken, add a number or middle initial rather than switching to something unrelated. Avoid inside jokes, numbers that date you, or words you might regret. A username like sarah-chen or jrodriguez tells people when ready who they are looking at. A username like codewizard2009 or pizzadev makes you harder to find and harder to take seriously.

Key Takeaways

  • Use your real name or a clear variation of it so employers and collaborators can find you and remember you.
  • Avoid numbers, dates, and slang that will look outdated or unprofessional in a few years.
  • Keep it short and straightforward to spell so people can type it correctly when they search for you.
  • Check that the username is available on other platforms where you work — LinkedIn, your personal website, Twitter — so your identity is consistent.
  • Do not use your full email address or password as your username, and do not reuse a username from a platform where you no longer have an account.

Why your real name is almost always the right choice

Employers search GitHub by name. Collaborators remember you by name. When someone reads your code in five years and wants to hire you, they search your name and expect to find you. If your GitHub username is mystical-coder, they will not find you, and you lose the opportunity.

If your name is common — Michael Johnson, Maria Garcia — adding a middle initial or last initial plus first name works well. mj-johnson, m-johnson, johnsonm, or mjohnson are all clear and professional. If your name has special characters, use the closest ASCII equivalent: jose-garcia instead of josé-garcía, because not every system handles accents the same way.

If your name is already taken on GitHub, do not pick a completely different username. Check whether the person using it is active. If the account has no repositories and no activity in years, you can contact GitHub Support to request the username. If it is actively used, add a number or middle initial to your name instead of switching to something unrelated.

What to avoid in a GitHub username

Do not use numbers that mark the year you created the account — sarah2015, dev2020. These dates age quickly and make your profile look abandoned. Do not use slang or inside jokes that only your friend group understands. Do not use words that might be offensive or embarrassing in a professional setting, even if they seem funny now.

Avoid usernames that are too long or hard to spell. sarah-elizabeth-chen-the-developer is harder to remember and easier to type wrong than sarahchen. Avoid usernames with consecutive numbers or random characters — dev12345 or coder_xyz — because they look like placeholder names and are hard to remember.

Do not use your email address as your username. Your email is private information, and putting it in your GitHub URL exposes it to spam and scraping. Do not reuse a username from a social media account you no longer use or maintain. If someone else takes over that account later, your GitHub username will point to a stranger.

Checking availability across platforms

Before you settle on a username, search for it on LinkedIn, Twitter, and your personal website or portfolio. If you are building a professional presence, having the same username across platforms makes you easier to find and more memorable. You do not need to be active everywhere, but the username should either be yours or unavailable — not owned by someone else.

Use a tool like Namechk or Knowem to check multiple platforms at once. Type your chosen username and see where it is taken and where it is free. If your first choice is taken on GitHub but free elsewhere, you might add a number or letter to make it work: sarahchen-dev or sarahchencode. The goal is consistency, not perfection.

How to change your username if you need to

GitHub allows you to change your username once, and the old name becomes available for someone else to claim after a short delay. When you change it, all your repository URLs change, but GitHub automatically redirects the old URLs for a while. However, direct links in documentation, comments, or external websites will break.

If you are thinking about changing your username, do it early — before you have published your GitHub URL widely or built a reputation under that name. If you have already shared your GitHub profile with employers, collaborators, or in your resume, changing it creates confusion and broken links. Choose carefully the first time.

Special characters and formatting

GitHub usernames can contain letters, numbers, and hyphens. They cannot contain underscores, spaces, or special characters like periods or slashes. If your name has a space or special character, use a hyphen to separate words: mary-smith instead of mary_smith or mary.smith. Hyphens are easier to read and more standard across platforms.

Usernames are case-insensitive on GitHub — SarahChen and sarahchen point to the same account. For readability, use lowercase with hyphens separating words. This format is easier to type, looks more professional, and works consistently across all systems.

What happens after you choose

Once you create your account, your username becomes part of your professional identity online. Every commit you make, every repository you create, and every contribution you make to open source will carry that username. People will find you by searching it. Employers will see it on your resume. It will appear in your email signature and on your portfolio.

This is why spending five minutes thinking about your username now saves you years of regret later. A good username is invisible — it does not distract from your work, it does not date you, and it does not make people wonder who you are. It straightforward tells them your name and gets out of the way.

Frequently Asked Questions

Can I use numbers in my GitHub username?

Yes, but avoid numbers that mark a year or look like a placeholder. If your name is taken, adding a single digit or your birth year works — sarah-chen-1 or jrodriguez88 — but sarah2015 or dev12345 looks outdated. Numbers are fine if they are part of your actual name or a meaningful identifier.

What if my name is very common?

Add a middle initial, middle name, or last initial. john-m-smith, jsmith, or john-smith-dev all work. If those are taken too, contact GitHub Support to see if the account is active. If it is abandoned, they may release it to you. Otherwise, pick a variation that is still clearly your name.

Should I use my full legal name or a nickname?

Use the name people know you by professionally. If everyone calls you Jim but your legal name is James, jim-smith is fine. If you go by a nickname that is not your legal name, use your legal name or a clear variation — employers will search for your legal name on background checks and may not find you otherwise.

Can I change my username later?

GitHub allows one free username change, and old URLs redirect for a while. However, direct links in documentation and external websites break. Change early if you must, but choose carefully the first time to avoid confusion and broken links after you have shared your profile widely.

What if someone is using my name on GitHub?

Check whether the account is active and has repositories. If it is abandoned with no activity in years, contact GitHub Support to request the username. If it is actively used, add a number or middle initial to your name instead. Do not pick a completely different username just to avoid a number.