WhatsApp Business Username: Setup Guide

Last updated: July 2026

TL;DR

• Setting up a WhatsApp business username is opening a public handle that customers can use to reach you without your phone number.
• The rules are strict: 3 to 35 characters, lowercase letters, numbers, periods and underscores only, at least one letter, no "www" or .com endings, no impersonation.
• The whole flow lives inside the WhatsApp app under Settings → Account → Username. There is no separate Business Manager step.
• For your automations and CRM, the real work happens after you claim the handle: make sure everything downstream reads the customer's BSUID (Business-Scoped User ID), not just their phone number.

The username feature is here, US customers are turning it on this month, and reserving your handle is a five-minute job. What takes longer is checking that your assistant, your CRM, and every workflow that touches a customer keeps working when the number stops showing up. This guide walks you through both.

Here's what the finished state looks like: your handle claimed, your number private, your customers able to reach you with an easy-to-remember @ mention instead of a phone number.

Illustrative rendering of the reserved-handle confirmation state. In practice, WhatsApp confirms with a simpler screen. Either way the message is the same: your handle is live and your number is under your control.

Before you start: check eligibility and pick a handle

Two decisions to make before you tap anything.

Are you eligible?

Usernames have been rolling out in phases since April 2026. The US rollout landed in late June, and wider markets are catching up through the rest of the year. You are eligible if:

• You have the latest version of WhatsApp Business installed on Android or iOS.
• Your account is in a market where the feature has reached general availability (US as of late June 2026, plus a growing list of other countries).
• You are using WhatsApp Business (the free small-business app) or your team is on the WhatsApp Business Platform through a BSP.

If the feature is close to reaching you, WhatsApp shows a "coming soon" screen with a preview of what usernames unlock and a link to learn more. Once your account gets the flip, the same screen turns into the full setup flow.

The pre-launch screen WhatsApp shows accounts approaching feature availability. If your app shows this, your setup flow is close.

If the Username option is missing from your settings entirely, the feature has not reached your account yet. Keep the app updated and check monthly.

If your team is on the WhatsApp Business Platform through a BSP (Business Solution Provider) instead of the free mobile app, username management lives inside WhatsApp Manager under Phone numbers → Profile → Username. Once reserved, the current handle, timestamp, and status show right in the profile view alongside your phone number, business preview card, and everything else Meta tracks for that account.

WhatsApp Manager view for Business Platform users. Your handle appears with status and last-updated timestamp, next to the business preview customers will see.

Picking a handle that will not be taken back

WhatsApp reserves the right to reclaim handles that impersonate a brand, so pick something defensible from day one.

The format rules:

• Length: 3 to 35 characters.
• Allowed characters: lowercase letters (a-z), numbers (0-9), periods (.), and underscores (_).
• Must include at least one letter. Pure numbers are blocked.
• No web patterns. No "www" prefix, no .com or other domain endings.
• No impersonation. Copying a real business, brand, or person is blocked. Notable accounts go through a verification path.

A safe pattern: use the exact name your customers already know you by, matched to what appears on your @ handle on Instagram or X if you already have one. If the base name is taken, try adding your city (your.brand.mx), your service line (your.brand.support), or your country code (your.brand.co).

Handles are first-come-first-served. If your business name is available, claim it now even if you are not ready to publish it. You can update your public materials later.

Step by step: set up your WhatsApp business username

The whole flow lives inside the WhatsApp app. Total time: about five minutes.

1. Update WhatsApp Business to the latest version from the App Store or Google Play.
2. Open WhatsApp Business and tap Settings in the bottom navigation.
3. Tap Account.
4. Tap Username. If it is not there, the feature has not rolled out to your account yet.
5. Type the handle you want. WhatsApp checks availability in real time.
6. Tap Save.

Once saved, your handle is live immediately. Customers can search for it, tap it in a shared link, or type it into a new chat window and reach you without your phone number appearing anywhere. Business Platform users go through the same steps in a web dialog rather than the mobile settings screen, but the rules and outcome are identical.

The username screen itself is minimal. Once your handle is set, you see the @ mark, your chosen handle, and the privacy control that decides who can find you by username.

The WhatsApp username screen once you've reserved your handle. The Contact me by username control appears directly below.

What changes for your customers

For a customer who messages you after you set up a username:

• They see your display name and username in the chat header.
• Your phone number still appears in chat details for businesses (only personal accounts hide the number). Your username is added on top, not instead.
• Customers can share your @handle in a WhatsApp click-to-chat link the same way they share a phone-number link today.

You control who can find you by username. Tapping into the Contact me by username setting gives you two options: anyone can search for your handle, or only people who have your username key can start a new chat.

The privacy control that decides who can reach you by handle. Most businesses leave this on Everyone because reachability is the point.

The technical side is where the real change is, and it started before your first customer set a username. As of early April 2026, incoming webhooks carry a BSUID (Business-Scoped User ID) for every customer, whether or not they have adopted a username. Any interaction returns a BSUID (messages, calls, in or out). Meta's guidance to partners: systems need to be updated and ready by June 2026, when the phone number field (wa_id) may start being empty for username-adopter customers. That is the deadline your automations need to be built against.

What to update after you claim the handle

Setting the username takes minutes. The follow-up work is where mistakes happen.

Update customer-facing materials

Anywhere you list a WhatsApp phone number is now a place you can list a username instead. The username is shorter, more memorable, and doesn't leak your number to strangers.

• Website contact page and footer. Replace or supplement the phone-number wa.me link with a username wa.me/@your-business link.
• Email signatures. For customer-facing team members.
• Physical signage and printed collateral. Business cards, in-store QR codes, receipts, and take-away menus.
• Instagram, Facebook, and Google Business Profile. The WhatsApp contact fields on these platforms accept your handle.
• Ad creative. Any ad that runs a click-to-WhatsApp button.

Do not remove the phone number version if it is already circulating widely. Both formats work. Add the username as the new default, keep the phone version alive so existing links do not break.

Update your CRM and automations

This is where the real work is, and it is why we recommend doing the setup before your customers push you into it.

Every system you have that treats "phone number" as the customer's identity needs to also read BSUID. When a customer with a username messages you, the phone number may not come through, so a CRM keyed only on phone will create duplicate records or lose the conversation history.

The full technical breakdown lives in our WhatsApp Usernames Explained guide, but the checklist is short:

• [ ] Your CRM has a BSUID field on the customer record.
• [ ] Your WhatsApp integration writes BSUID from every incoming webhook, alongside phone number when present.
• [ ] Your dedup logic merges by BSUID first, phone number second.
• [ ] Your AI assistant, ticketing system, and analytics all read BSUID so a customer's history stays stitched to one record.

If you use a WhatsApp platform that already handles BSUIDs behind the scenes, most of this is done for you. Ask your provider directly if you are not sure.

Update your AI assistant, if you have one

If you run an AI assistant on WhatsApp, three things need attention:

1. Contact matching. The assistant should recognize a returning customer by their BSUID so it does not treat them as brand new.
2. Persistent memory. Any customer memory your assistant stores (past orders, preferences, open tickets) should be keyed on BSUID.
3. Handoff to a human. When your assistant hands a conversation to a team member, the human agent sees the BSUID and the customer record, not just an anonymous handle.

At Invent, the AI assistants have handled BSUIDs since Meta first published the webhook format. If you built a custom bot with someone else's stack, worth confirming the BSUID path is wired up before your first "why doesn't the bot remember me" support ticket.

What can go wrong

A short list of what usually trips businesses up.

• Username taken. Someone else already has the name you want. Options: pick a close variant, or if a competitor or squatter is impersonating you, submit an impersonation report through Meta's official Business Help Center.
• Feature not visible in the app. Rollout is phased. Keep the app updated and check monthly.
• Customers still landing on your old phone-number link. That's fine. Both wa.me/PHONE and wa.me/@USERNAME route to the same chat. Update your new links to the username; leave the old ones alone.
• Automations losing conversation history. Almost always a BSUID handling gap. Fix it in your integration, not by asking the customer to identify themselves.
• Team member sees a chat but no phone number. Expected. Show them the BSUID and the customer's history from your CRM. Phone-number-only workflows will feel incomplete going forward.

What we're building at Invent

At Invent, we build AI assistants for WhatsApp that work whether your customer contacts you via phone number, business username, or any of the other messaging channels we connect to. Our webhook integration reads BSUIDs from day one, the customer record in the unified inbox merges every touchpoint into a single thread, and the persistent memory travels with the customer across their entire history with your business.

That way when a customer switches to a username, nothing on your side has to change. The assistant remembers them, the human agent sees the full history, and no one has to ask "have we spoken before?" because your systems already know.

Set the handle, then check the plumbing

Reserving your WhatsApp business username is a five-minute setup and a fifteen-minute follow-up. The follow-up is the part that pays off long after the news cycle on usernames dies down: automations that treat customers by identity instead of by phone number, memory that persists as people update their contact info, and a support experience that feels the same whether the customer's number is visible or not.

Do the setup this week. Do the follow-up before the deadline forces it.

FAQs

Do I need a Meta Business Manager account to set up a WhatsApp business username?

No. If you use the WhatsApp Business app, you set it up directly in Settings → Account → Username. Meta Business Manager is only involved if you use the WhatsApp Business Platform through a BSP, in which case your provider handles the plumbing.

Can I change my WhatsApp business username later?

Yes. WhatsApp allows username changes, though not unlimited. If you change it, share the new handle with your customers proactively. Old @handle links stop working after a short cooldown so the old name can be released back to the pool.

Will my WhatsApp business username hide my phone number?

Not on business accounts. On WhatsApp Business, the phone number still shows in chat details. The username is an additional public handle, not a replacement. If you want your number hidden entirely, that behavior is currently only available on personal accounts.

Does a WhatsApp business username cost anything?

No. Reserving a username is free through the WhatsApp Business app. If you use the WhatsApp Business Platform, per-conversation pricing from Meta is unchanged. The username itself carries no additional fee.

What is a BSUID and do I need one?

A Business-Scoped User ID is an identifier Meta assigns to each customer for your specific business. It appears in every incoming message webhook and lets you identify a returning customer even when their phone number is not visible. If you run automations or a CRM, you need to store and match on BSUID. Full detail in our WhatsApp Usernames Explained guide.

Can I claim a username that matches my brand if someone else already has it?

Only if you can prove ownership. Meta runs an impersonation and verification path for notable brands. If a squatter has your exact business name, submit an impersonation report through Meta's official form and provide proof of ownership (trademarks, business registration, official website).

Related

• WhatsApp Usernames Explained: What Businesses Need to Know
• WhatsApp Username vs. Business Phone Number: Which to Use

Reserve the handle, wire up the BSUID, keep the number for backwards compatibility.