WhatsApp Usernames Are Coming: What It Means for Builders (2026)
WhatsApp is rolling out usernames so people can message you without knowing your phone number. Here's what we know, how it works, and how to build for it on a messaging API.
WhatsApp is finally adding usernames.
Instead of sharing a phone number with every customer, you'll be able to share a username like @yourbusiness. People can search for it and message you directly. No phone number required.
This is a big deal, especially if you build the messaging side of a product yourself. Here's what we know so far, and what it means at the API level.
What Are WhatsApp Usernames?
Right now, to message someone on WhatsApp, you need their phone number. That's been true since the app launched in 2009.
Usernames change that.
With the new feature, you can:
- Create a unique username for your account (like
@miamihairsalon) - Share that username instead of your phone number
- Let customers find you by searching your username in WhatsApp
- Keep your phone number private from people who message you
Think of it like Instagram handles, but for WhatsApp.
How It Works
Based on what's been tested in beta versions, here's the flow.
Setting Up Your Username
- Go to WhatsApp Settings
- Look for the "Username" option (rolling out gradually)
- Choose your unique username
- Save it
Your username appears in your profile and can be shared publicly.
Starting a Conversation
When someone wants to message you:
- They open WhatsApp and go to the search bar
- They type your username (e.g.,
@yourbusiness) - They tap to start a conversation
- Your username shows as the chat title (not your phone number)
If you don't have each other's numbers saved, your phone number stays hidden. They just see your username.
Privacy Protection
This is the key part: your phone number remains private unless both parties have each other saved in their contacts.
For businesses, this means:
- New customers can message you without you sharing personal contact info
- You can advertise your username publicly (on Instagram, flyers, your website)
- Your actual phone number stays protected
What This Means at the API Level
If you build on the WhatsApp Business API rather than tapping replies on a phone, usernames are mostly good news, with one thing worth planning for.
Usernames are a discovery layer, not a new identity. A conversation that starts via @yourbusiness still maps to the same business account behind the API. Your webhook still fires on inbound messages exactly as before.
Plan your contact key. If you key customer records on phone number today, decide how you'll handle contacts whose number you can't see yet because they reached you by username. Many builders key on the platform-provided contact ID and treat the phone number as an optional, later-captured field:
await db.contact.upsert({
where: { waContactId: event.contact.id }, // stable, always present
create: {
waContactId: event.contact.id,
username: event.contact.username ?? null,
phone: event.contact.phone ?? null, // may be null until shared
},
update: { lastSeenAt: new Date() },
});
Channels already support usernames. If you've created a WhatsApp Channel (the broadcast feature), you can already set a username for it. Personal and business chat usernames are the next step. (If you're sizing API costs, see our WhatsApp API pricing breakdown.)
Why This Matters for Builders
If you run a business and build your own messaging layer, usernames solve a real distribution problem.
The Current Situation
Right now, to let customers message you on WhatsApp, you either:
- Share a personal number (mixing business and personal life)
- Get a separate business line (extra cost, extra device)
- Use the WhatsApp Business API (the path you want if you're building anything custom)
With Usernames
You can:
- Print
@yourbusinesson your business cards - Add it to your Instagram bio
- Put it on your website
- Share it in ads
Customers message you through that username. Your actual phone number stays private. If you ever change numbers, your username stays the same.
And here's the key part for builders: that username still connects to the same WhatsApp Business account, so it still flows through the same API and the same webhook you've built against. If you've connected your number to Wabery, a message that arrives via your new username hits the exact same event handler as everything else. Nothing changes in your code. You just get a cleaner way for customers to find you.
What to Do Now
The feature is still rolling out, but here's how to prepare.
1. Decide on Your Username
Think about what username you want. Keep it:
- Short and memorable (easier to share)
- Related to your business name (so customers recognize it)
- Easy to spell (avoid numbers and special characters if possible)
Good examples:
@mikisnailstudio@downtownbarbershop@relaxspa_miami
2. Watch for the Feature
Check your WhatsApp settings periodically. The username option is rolling out to different users at different times. When you see it, claim your preferred username quickly. Popular names will go fast.
3. Update Your Marketing Materials
Once you have your username, update:
- Your website contact section
- Your Instagram/Facebook bio
- Your Google Business profile
- Business cards and flyers
- Any "Message us on WhatsApp" links
4. Get Your Messaging Layer Built on Wabery Now
This is the part you don't want to leave until launch day: stand up your WhatsApp Business integration before usernames go live.
When you build on Wabery:
- All inbound messages, whether from a phone number or a username, arrive at one webhook through the unified channels API
- You can collect structured details with a WhatsApp Flow instead of parsing free text
- Customer records build from every event, in your own database
- You're ready the moment usernames go live, no rework required
The CLI and MCP server make the first wire-up quick. Scaffold the webhook, point a Flow at it, and you've got a working messaging layer before you've even claimed @yourbusiness.
Someone messages your username, your handler responds, and the conversation flows through the system you built. The customer never needed to know your phone number. That's the future, and it's coming soon.
Frequently Asked Questions
When will usernames be available?
WhatsApp is testing the feature in beta now (January 2026). There's no confirmed public launch date, but it's expected soon. Some users already have access to username reservation.
Will usernames replace phone numbers?
No. Phone numbers remain the primary way WhatsApp accounts work. Usernames are an additional option for sharing and discovery. You still need a phone number to create a WhatsApp account.
Can I change my username later?
Based on how similar features work on other platforms, you'll likely be able to change it. But your old username might become available for others to claim. Best to pick one you'll stick with.
What if someone takes the username I want?
First come, first served. If @yourbrandname is taken, you might need to add a location (@yourbrandname_miami) or variation. This is why claiming early matters.
Do usernames work with the WhatsApp Business API?
Yes. The feature is designed to work with both the regular WhatsApp app and business accounts. If you're building on the API through a platform like Wabery, a username conversation arrives at the same webhook as any other message. From your code's point of view, nothing changes.
Is this the same as WhatsApp Channels?
No. Channels are one-way broadcast feeds (like a newsletter). Usernames are for regular two-way conversations. Channels already support usernames for discovery; this extends that to regular chats.
The Bigger Picture
WhatsApp usernames are part of a broader privacy push. Meta is giving users more control over who has their phone number and how they're discovered.
For builders, this is mostly upside:
- Easier for customers to find you
- Less friction in starting conversations
- Your personal number stays personal
- A username looks more professional than a raw phone number
The main risks are username squatting and stale assumptions in your code. If you have a recognizable brand, claim your name early. And if your data model assumes you always have a phone number, fix that before usernames make it false.
Get Ready Now
WhatsApp usernames are coming. Here's the builder's checklist:
- Pick your ideal username now (write it down before someone else claims it)
- Build your messaging layer on Wabery today (don't wait for usernames to launch)
- Key your contacts on a stable ID, not just the phone number
- Watch for the username feature in your WhatsApp settings
- Reserve your username the moment it's available, then update your marketing
The teams that win will be the ones already built when usernames go live. Your webhook will be live, your Flows will be ready, and your customers will find you at @yourbusiness instead of a random phone number.
Wire up the channels API and webhook now. When usernames launch, you'll be ready: customers message your username, your code handles it, and every conversation lands in the system you built.
Questions or feedback? Reach out anytime