The vocabulary of the Username Generator API

The 10 fields and concepts you'll meet in the response — defined in plain English, each with a real example value.

10 terms
Validation2

Username Validation

The process of checking if a username meets platform rules and policies.

Validation includes: length checks (min 3, max 30), character restrictions (letters, numbers, underscores, hyphens), profanity filtering, reserved name blocking, and uniqueness verification. Validation happens client-side (instant feedback) and server-side (authoritative check before creating account).

Example"user@name!" fails (special chars), "john_doe_123" passes

Availability Check

Verifying whether a username is already taken on the platform.

Availability checks query the user database for exact matches (case-insensitive). For performance, index the username column and consider caching recently checked names for 5-10 seconds. Provide instant feedback during signup. When unavailable, suggest alternatives.

ExampleCheck: "johndoe" → Taken. Suggestions: "johndoe23", "john.doe"

User Identity1

Display Name

A changeable, non-unique name shown to other users, separate from the unique username identifier.

Username is for identification (@johndoe123), display name is for presentation ("John Doe"). Display names can contain spaces, special characters, and emoji. They can be changed without breaking @mentions or URLs. This separation improves flexibility while maintaining stable identity.

Exampleusername: "j.doe.1985" (unique), displayName: "John Doe" (can duplicate)

Platform Policy3

Username Squatting

Registering desirable usernames with intent to sell, impersonate, or prevent others from using them.

Squatters register @nike, @apple, @celebrity names to sell to the rightful owners. Prevention: reserve brand names, implement verification for notable accounts, reclaim inactive accounts after 12+ months, limit accounts per email/IP. Some platforms auction premium usernames rather than allowing free registration.

ExampleUser registers @Starbucks hoping to sell it to Starbucks Corporation

Reserved Names

Usernames that are blocked from registration to protect system functions, brands, or prevent abuse.

Common reserved categories: system accounts (admin, moderator, support), your company brand, competitor brands (anti-phishing), common misspellings of reserved names, offensive/profane terms. Maintain allowlist for legitimate uses and blocklist for always-prohibited. Update quarterly.

ExampleReserved: admin, support, yourcompany, adm1n, supp0rt

Username Portability

The ability (or inability) to change usernames after account creation.

Immutable usernames (can't change) ensure stable @mentions and profile URLs but frustrate users who want to rebrand. Changeable usernames improve UX but break old links and @mentions. Compromise: allow username changes but keep old username reserved for 30-90 days and redirect to new profile.

ExampleTwitter allows username changes; Discord uses immutable user IDs + changeable display names

Technical Implementation1

Case-Insensitive Username

Treating usernames as identical regardless of capitalization (e.g., "User" and "user" are the same).

Case-insensitive matching prevents confusion and impersonation. Users can display their name with preferred capitalization (@JohnDoe) but searches/logins work with any case. Implementation: store lowercase version for comparison or use database case-insensitive collation.

ExampleUser types "JohnDoe", system stores "johndoe", both login as same account

Generation1

Username Generation

Automatically creating username suggestions for users during registration.

Generation approaches: pattern-based ([Adjective][Noun]), personalized (based on name/interests), random but pronounceable (Markov chains), or combinations with numbers. Always check generated names for availability and profanity before suggesting. Offer 5-10 options.

ExampleGenerate from "Sarah": SarahSmith, SarahTheGreat, QuickSarah, Sarah_92

Social Features1

Mention/Tagging

Referencing a user in content using their username, typically with @ prefix (@username).

@mentions notify the referenced user and create hyperlinks to their profile. Implementation: parse text for @username patterns, validate against user database, replace with links, send notifications. Mentions are why usernames shouldn't contain spaces or special characters.

ExampleText: "Great work @johndoe!" → Notifies user johndoe, links to profile

Trust & Safety1

Verified Account

An account confirmed as authentic, typically for notable people, brands, or organizations.

Verification (often shown with a checkmark badge) proves the account represents who it claims. Prevents impersonation of celebrities, brands, journalists. Verification requires proof of identity: government ID, official email, business documentation. Reserve the actual brand username and offer verification.

Example@Nike (verified ✓) vs @Nike_Shoes (unverified, potentially fake)

See these fields live. Run the Username Generator API free — no card, no signup wall.

Scaling up?

Volume pricing, custom SLAs, and dedicated support for high-traffic teams.

Contact sales