Built on the official Meta WhatsApp Business API Official Meta WhatsApp Business API See plans

Contact lists, segments, tags and custom fields

5 min read Updated 19 Nov 2026

This guide explains the four ways to organise your contacts: contact lists, segments, tags and custom fields. Use them so each campaign reaches only the right people. You need some contacts added first.

What each one is for#

All four are labels you attach to contacts. They are simple groups that you fill yourself. The platform does not add contacts to a group by rules or conditions.

LabelUse it forUsed in campaigns
Contact listWhere the contact came from, for example "Diwali sale customers" or "Website sign-ups".Yes, as an audience choice
SegmentA group by interest or type, for example "Gold customers" or "Delhi".Yes, as an audience choice
TagA quick note on a contact, added from the Inbox, for example "Not interested".Yes, to include or exclude contacts
Custom fieldExtra details on a contact, such as city, birthday or customer ID.No, only stored on the contact

A contact can belong to many lists and many segments at the same time.

Contact listsWhere they came from
SegmentsWhat they are like
TagsInclude or exclude
Your contactCan have many of each
Campaign audienceList and segment must both match
How the labels work together. A campaign audience is built from lists, segments and tags. Custom fields are only stored on the contact.

Create a contact list#

  1. Open Contact ListsIn the left menu click WhatsApp, then Contact Lists. You see the My List screen with the Title, Contacts and Action columns.
  2. Click Add NewA small form opens. Type a Name. The Status switch is on by default.
  3. Click SubmitThe list appears in the table. A list name can be used only once in your account. A repeated name shows "the contact list has already been taken".
  4. Add people to the listClick the small user-plus button in the Action column. A form opens to add a new contact straight into this list. You can also tick contacts on the Contacts screen and use Bulk Action, then Add List.

Open Contact Lists

yourdomain.com/client/contacts-list
Dashboard
WhatsApp
Campaigns
My List Add New1
TitleContactsAction
Diwali sale customers1202
The Contact Lists screen. Segments work the same way.
  1. Add New creates a list
  2. User-plus adds a new contact straight into this list

Use the pencil icon to rename a list or switch its status off. A list with the status off does not show in the drop-downs. The bin icon deletes the list.

Create a segment#

  1. Open SegmentsIn the left menu click WhatsApp, then Segments.
  2. Click Add NewType the segment name in the Segments box. The Status switch is on by default.
  3. Click SubmitThe new segment appears in the table. You can edit or delete it with the icons in the Action column.
  4. Add contacts to itChoose the segment when you add or edit a contact, or tick several contacts on the Contacts screen and use Bulk Action, then Add Segment.

Open Segments

Tip

Keep a simple rule. Use lists for "where did they come from" and segments for "what are they like". Names such as "Hot leads" or "Repeat buyers" are easy to pick later in a campaign.

Add tags to contacts#

Tags are added in the Inbox, while you talk to a customer. See Use the shared inbox for the basics.

  1. Open a chatClick Inbox in the left menu and select a customer.
  2. Find the Tags boxOn the right side, in the contact details panel, you see the heading Tags with a plus icon and a gear icon.
  3. Create a new tagClick the plus icon, type the tag title in the box and click Save. The tag shows on the contact. A tag title must be new, otherwise you see "The tag title already exists".
  4. Use tags you made beforeClick the gear icon. A list of your tags opens. Select the ones that fit this contact and click Save. The tags you select replace the earlier tags on this contact.
yourdomain.com/client/inbox
Contact details

Aarav Sharma

Tags123
Not interestedRepeat buyer
Tags in the Inbox. The details panel on the right of a chat holds the Tags box.
  1. Tags heading in the contact details panel
  2. Plus icon creates a new tag
  3. Gear icon picks tags you made before

In the Inbox you can also filter chats by tag using the All Tags drop-down. In a campaign you can send only to contacts with certain tags, or leave out contacts with certain tags, for example everyone tagged "Not interested".

Create custom fields#

  1. Open Custom fieldsGo to WhatsApp, then Contacts, and click Custom fields at the top right. You see the Contact Attributes list.
  2. Click Add NewType a Title and choose a Type. The available types are Text, Number, Email, URL, Date and Time.
  3. Click SaveThe field is saved and appears on the Add New contact form and the edit form. Fill it in for each contact.

Open Custom fields

Note

Custom field values are stored on the contact, so you can keep your records in one place. They are not available as variables when you send a campaign. In a campaign, variables can use the contact name, the contact phone or a value you type. See Send your first campaign.

Common problems#

My list or segment is missing in a drop-down

Only lists and segments whose status is on are shown. Open the list or segment with the pencil icon and switch Status on.

The custom field title is rejected

The title is required, up to 255 characters, and must be different from other custom field titles. Choose a more specific title, for example "Customer city".

A campaign reaches fewer people than I expected

If you pick both a list and a segment, only contacts in both groups are counted. Tags can also exclude people. The Total Contact number on the campaign screen shows how many will receive it.

Need help?#

If you are stuck, contact support on WhatsApp +91 99159 60958 or email info@whatsappmarketingagency.com, or use the contact page. To add people first, read Add and import contacts.

Was this guide helpful?
Black Friday Sale – Get 20% OFF!
Latest offer

Black Friday Sale – Get 20% OFF!

Unlock smarter business communication this Black Friday! Enjoy 20% OFF on all WhatsApp Marketing Agency plans, including WhatsApp Business API, bulk messaging, AI chatbots, CRM integration and automation. Use coupon code BLACKFRIDAY20 at checkout. Limited-time offer: 27–30 November 2026.

Claim 20% OFF Now