GitHub Username Checker: Understanding the Hyphen Rule

A GitHub username appears in your profile URL and in links you may share with collaborators or employers. Choose a spelling that is easy to recognize, then check its format and availability with the GitHub username checker. Confirm the final choice in GitHub’s own account settings.

A format error and an unavailable name are different results. Check the current rules before trying more variations.

The Strict Formatting Rules

A GitHub username becomes part of profile and repository URLs. A readable name is easier to share, but it still needs to meet GitHub’s formatting rules.

• The Character Limit: Your custom username cannot exceed 39 characters. Choose a username within GitHub’s current character limit.
• Letters, digits, and hyphens: Use English letters and digits; a hyphen is also allowed when it follows the placement rules below.

Where hyphens can go

GitHub permits a single hyphen between characters, with placement restrictions worth checking before you submit a name.

You are strictly prohibited from using multiple consecutive hyphens (e.g., john--doe). Furthermore, your username absolutely cannot begin or end with a hyphen (e.g., -johndoe or johndoe-).

If your first choice is taken, compare a short hyphenated variation such as john-doe with a descriptive word or number that means something to your audience. Say each option aloud and check the resulting profile URL; no separator is best for everyone.

No Underscores Allowed

A candidate such as first_last fails because GitHub usernames do not permit underscores. If you need a separator, try a single hyphen between letters or numbers and confirm the final name in GitHub.

Frequently Asked Questions (FAQ)

Is a GitHub username case-sensitive? GitHub treats username case as equivalent for account identity. Use the capitalization you prefer for display, but do not treat it as a separate available name.

Does a short valid name have to be available? No. Format checks do not reserve a name. Try the exact candidate in GitHub and keep a readable alternative ready.

Can I change my username later? Yes. Some old links redirect and others do not. Review GitHub’s username-change guidance, then update the profile links and remotes you control.

Before sharing a profile link, check both its format and its destination.