Dughri
Usernames

WhatsApp business usernames get a change limit, and customer numbers may be hidden

Each business number can now change its username only twice in 14 days. Customers who adopt usernames may reach you without a phone number.

  • Published
  • 3 min read
  • 2 official sources

Key points

  • Each business number can set a new username 2 times in any rolling 14 days, or 10 if the name is reserved.
  • Deleting a username does not reset the limit; your old name is held for 60 days.
  • When a customer turns on a username, you may get a business-scoped ID instead of their phone number.
  • Systems that track only phone numbers can lose conversations and fail to send some authentication templates.

What changed

There are two changes on the WhatsApp Business Platform, and both are about usernames.

The first affects your business. Each business phone number can set a new username only 2 times in any rolling 14-day period. If the username you request comes back with a reserved status, the limit is 10 times in that period.

The second affects your customers. A WhatsApp user can turn on a username of their own. When they do, you may stop receiving their phone number. Instead, you get a business-scoped user ID (BSUID): an ID that identifies that customer to your business.

The official details are on Meta's page about business-scoped user IDs.

What it means in practice

Your own username

  • The limit applies to each phone number separately, and the 14-day window rolls rather than resetting on a fixed date.
  • Deleting a username does not reset the limit. Deleting and recreating a username is no way around it.
  • When you hit the limit, the error does not say when you can try again. You can set a new username 14 days after the earliest username change in the current window.
  • After you change your username, the previous one is held for 60 days, and you can claim it again during that time. See the WhatsApp help center.
  • A business username does not hide your business phone number in the app. It is not a privacy feature for businesses.

Your customers' phone numbers

  • If a customer turns on a username, their phone number is not included in webhooks (the updates WhatsApp sends to your systems), unless you have interacted with them before.
  • That check uses a 30-day lookback, and it is evaluated per business phone number. If a customer contacted your sales number, your support number may still not see their phone number.
  • Meta says you cannot control whether customers adopt usernames, so you must support BSUIDs to avoid losing the ability to process their messages.
  • A BSUID works only with phone numbers owned by the same business portfolio. Messages sent to it from a number owned by a different portfolio will fail.
  • You can send any type of message to a BSUID except one-tap, zero-tap and copy code authentication templates. Those still require the customer's phone number.

Systems that track only phone numbers

If your CRM, inbox or helpdesk identifies customers only by phone number, it can:

  • Lose some customers' conversations.
  • Fail to send some authentication templates.
  • Miss the phone number a returning customer used.

How to prepare

  1. Ask your provider or tech team one question: do we support BSUIDs? Customer records should accept a BSUID, not only a phone number.
  2. Decide who is allowed to change your business username, and log every change with its date. With only 2 changes per 14 days, a hasty change can leave you waiting.
  3. Do not try to get around the limit by deleting and recreating the username. Deleting does not reset it.
  4. If you regret a username change, reclaim the old name within 60 days.
  5. Check which business portfolio owns each of your phone numbers. A BSUID can only be messaged from numbers in the same portfolio, so plan hand-offs between teams with that in mind.
  6. Review your login and verification flows. If you use one-tap, zero-tap or copy code authentication templates, you need the customer's phone number for them.
  7. Use the request-contact-info button when you need a customer's phone number. It can be added to utility and marketing templates, or sent as an interactive message.
  8. Do not rely on the Meta-hosted contact book for past customers. It stores phone numbers only from interactions after it launches; earlier interactions are not added.
  9. Do not use a business username to hide your business number. It will not hide it.

Official sources

This article simplifies information published by Meta. The official documentation is the reference where they differ, and it may change after publication.