For the complete documentation index, see llms.txt. This page is also available as Markdown.

WhatsApp Business Username

Claim your channel's Whatsapp Business User name now

Who can use this?

  • Gallabox users with the Update Channel permission.

  • Roles: Admin and Owner only. Other roles see the Claim button disabled with a tooltip asking them to contact an admin or owner.

What is a WhatsApp Business Username?

A WhatsApp Business username is a unique handle (like @mayacakes) mapped to your WhatsApp business phone number. Once approved by Meta, customers can find and message your business on WhatsApp by searching for your username β€” they no longer need to know or save your phone number. Your username appears on your business profile across WhatsApp.

Claiming a username does not hide your phone number. Customers who have your number can still see and use it.

Usernames are available only for WhatsApp channels connected through the Cloud API (Meta, Meta Tech Partner, Gupshup, Tata, Karix, Redington, or custom partner). Sandbox channels and channels connected via WhatsApp Co-existence cannot claim a username.

Username Statuses

Status
Badge colour
What it means

Reserved

Yellow

Your username request was accepted and the handle is held for you. It becomes visible to WhatsApp users once Meta rolls out the username feature in your region.

Approved

Green

Your username is active and visible to your customers on WhatsApp.

How to Claim a Username

  1. Go to WhatsApp in the left nav.

  2. Open Channel Settings and select your WhatsApp number from the connection dropdown at the top right.

  3. In the channel header, find the Claim username banner ("Reserve your handle") and click Claim.

  4. In the Claim Username window, pick one of the Suggested usernames for your business, or type your own handle in the Username field.

  5. Click Claim.

You'll see a Username claimed confirmation, and the banner updates to show your handle with its status β€” Username successfully reserved (yellow) or Username claimed β€” visible to your customers (green).

Username rules

Gallabox validates your username before submitting it to Meta:

  • 3–24 characters

  • Lowercase letters, numbers, periods (.), and underscores (_) only

Meta applies additional rules on its side β€” a request that breaks any of these is rejected:

  • Must contain at least one letter

  • Must not start or end with a period, or contain two consecutive periods

  • Must not start with www

  • Must not end with a domain suffix (.com, .org, .net, .in, and so on)

  • Case is ignored when comparing usernames, but periods and underscores are not β€” mayacakes, maya.cakes, and maya_cakes are three different usernames

How to Delete a Username

  1. In the Channel Settings header, find the banner showing your @username.

  2. Click the trash icon on the right of the banner.

  3. In the Delete Username window, click Delete.

Your username is released immediately and is no longer visible to WhatsApp users. You may not be able to reclaim the same handle straight away.

To change your username, delete the current one and claim a new one using the steps above.

Example

Scenario: Maya Cakes, a home bakery, runs Instagram ads but customers keep losing the bakery's phone number. The owner wants customers to find the bakery on WhatsApp by name.

  1. The account Owner opens WhatsApp β†’ Channel Settings and selects the Maya – Gupshup number.

  2. She clicks Claim on the Claim username banner. The suggestions show @mayacakes and @mayacakesbakery.

  3. She selects @mayacakes and clicks Claim.

  4. The banner turns yellow with Username successfully reserved. Once Meta activates usernames in her region, it turns green β€” and customers can now find the bakery on WhatsApp by searching @mayacakes, no phone number needed.

FAQs

I claimed a username but it says "Reserved" β€” why can't my customers see it?

Reserved means Meta accepted your request and is holding the handle for you, but the username feature hasn't been rolled out in your region yet. It switches to Approved and becomes visible automatically once Meta activates the feature β€” you don't need to do anything.

The Claim button is greyed out for me. Why can't I click it?

Claiming and deleting usernames requires the Update Channel permission, which Admins and Owners have. Ask an admin or owner on your account to claim the username, or to upgrade your role.

I don't see the Claim username banner in Channel Settings at all.

The banner only appears for WhatsApp channels connected through the Cloud API (Meta, Meta Tech Partner, Gupshup, Tata, Karix, Redington, or a custom partner). It's not available on sandbox channels or numbers connected via WhatsApp Co-existence.

My username was rejected even though it follows the character rules.

Meta enforces extra rules beyond the character set: the username must contain at least one letter, can't start with "www", can't end with a domain suffix like .com or .in, and can't start/end with a period or contain two consecutive periods. It also fails if the exact handle is already taken by any other WhatsApp number β€” usernames are unique across all of WhatsApp.

It says the username is already in use by another phone number in my portfolio.

A username maps to exactly one phone number. If another number in your business portfolio (or your Facebook Page / Instagram account) already holds that handle, either pick a different username, or release it from the other number first. If the handle belongs to your Facebook Page or Instagram account, link your WhatsApp business phone number to that Page or account in Meta Business Suite, then claim it again.

I deleted my username by mistake β€” can I get it back?

Claim it again from the same Claim username banner. Be aware the handle may not be immediately available for reclaiming after deletion, and another business could claim it in the meantime.

Will claiming a username hide my phone number?

No. A business username does not hide your business phone number in WhatsApp β€” customers who have your number can still see it. The username is an additional way for customers to find you.

Next Steps

  • Complete your WhatsApp profile (display picture, address, business description) in Channel Settings β†’ Profile so customers who find you by username see a complete business page

  • Add your @username to your Instagram bio, website, and marketing material once it shows Approved

Last updated