WhatsApp usernames let you add people without sharing your phone number

WhatsApp usernames are optional handles you create in your account settings — they look like @username instead of a phone number. When someone has set a username, you can search for and add them directly without exchanging phone numbers or contact details. This works on both Android and iPhone, and the person you're adding doesn't need to accept a request; they appear in your contacts once you've found and added them.

The username feature rolled out to all WhatsApp users in late 2023, so if you're using a recent version of the app, you have access to it. Not everyone has created a username yet, so you may still need phone numbers for some contacts — but if the person has set one up, searching by username is faster and more private.

Key Takeaways

  • Open WhatsApp, tap the contacts icon, and select "Add contact by username" to search for someone's handle instead of their phone number.
  • Type the username exactly as they've shared it (usernames are case-sensitive and cannot contain spaces).
  • Once you find the person, tap their profile and select "Add to Contacts" to save them to your phone.
  • The person does not need to approve the addition — they will see you in their contacts once you've added them.
  • If the username search returns no results, the person either hasn't created a username or you've typed it incorrectly.

Finding the "Add by Username" option on your phone

On Android, open WhatsApp and tap the three-dot menu icon in the top right corner. Select "New contact" or look for an option that says "Add contact by username" — the exact wording depends on your app version. On iPhone, open WhatsApp, go to the Chats tab, and tap the compose icon (pencil in a square) in the top right. You should see an option to "Add contact by username" near the top of the screen.

If you don't see this option, your WhatsApp version may be outdated. Go to the Google Play Store (Android) or App Store (iPhone), search for WhatsApp, and tap "Update" if an update is available. The username feature requires WhatsApp version 23.25.0 or later on Android and a recent version on iPhone.

Searching for and adding the person by username

Once you've opened the username search screen, type the person's username exactly as they've given it to you. Usernames are case-sensitive, meaning @JohnSmith is different from @johnsmith. They also cannot contain spaces, so if someone tells you their username verbally, ask them to write it down or send it to you in a message to avoid mistakes.

Tap the search icon or press Enter. If the username exists, WhatsApp will show the person's profile picture, their display name, and their status message. Review this information to make sure it's the right person — usernames don't always match display names, so a profile picture is your best confirmation. Once you're certain, tap "Add to Contacts" or the plus icon to add them to your WhatsApp contacts.

What happens after you add someone by username

The person appears in your WhatsApp contacts when ready, and you can start a conversation with them right away. They will see you in their contacts list as well, even though they didn't approve the addition. This is different from some other messaging apps — WhatsApp doesn't use a "friend request" system for usernames.

The person will see your display name and profile picture in their contacts, just as you see theirs. If you want to message them, you can open the chat and send a message. They'll receive it like any other WhatsApp message. If either of you has blocked the other, the message won't go through, but blocking is a separate setting from adding by username.

Troubleshooting when the username search doesn't work

If you search for a username and get no results, the most common reason is a typo. Usernames are case-sensitive and must match exactly, so double-check every letter and number. Ask the person to send you their username in writing — a screenshot, text message, or email — rather than spelling it out verbally.

The second possibility is that the person hasn't created a username yet. WhatsApp usernames are optional, so many users still rely on phone numbers. If the search fails, ask the person for their phone number and add them the traditional way. You can also ask them to create a username in their WhatsApp settings (Settings > Account > Username) if they want to be found this way in the future.

Creating your own username so others can find you

If you want people to be able to add you by username, you need to create one first. Open WhatsApp, go to Settings (the gear icon on Android, or tap Settings at the bottom right on iPhone), then tap Account. Select "Username" and tap "Create username." WhatsApp will suggest a username based on your display name, but you can change it to anything you want.

Usernames must be between 5 and 32 characters long and can only contain letters, numbers, periods, and underscores. Once you've created a username, you can share it with others, and they can find you using the method described above. You can change your username anytime, and your old username becomes available for someone else to use.

Frequently Asked Questions

Can I add someone by username if they have their account set to private?

WhatsApp usernames don't have privacy settings — if someone has created a username, anyone can find and add them by searching for it. Privacy on WhatsApp is controlled through other settings like "Last Seen" and "Profile Photo," not through username visibility.

What if I add someone by username and they block me?

If someone blocks you after you've added them by username, you won't be able to send them messages or see their status. Blocking is separate from the username system. If you think you've been blocked, try sending a message — WhatsApp will tell you if the message couldn't be delivered because you're blocked.

Do I need their phone number to add them by username?

No. The whole point of usernames is to add someone without exchanging phone numbers. Once you've added them by username, their phone number stays private unless they choose to share it with you later.

Can I search for someone's username if I only know their display name?

No. The username search only works if you know the exact username. Display names and usernames are separate — someone's display name might be "John" but their username could be @j_smith_2024. You need the username itself to search.

What if someone gives me a username that doesn't exist?

The search will return no results. This usually means they made a typo when telling you, or they haven't actually created a username yet. Ask them to confirm the username by sending it to you in writing, or ask for their phone number as an alternative.