Labels, Lists & Custom Fields
Organise contacts with labels and lists, store per-contact data in custom fields, and use them to target broadcasts and personalise messages.
Labels, lists and custom fields turn a flat contact list into something you can target and personalise. Manage all three from Subscriber Manager → Manage.
Labels — "which group is this person in?"#
A label is a tag such as New lead, Paid customer, Kozhikode or Interested – Wedding. A contact can have many.
Labels get added by: - you or your team, in the inbox or Subscriber Manager (Bulk Actions → Assign Label); - a Label Assign block in a chatbot flow; - the import screen (choose a label for everyone in the file); - a broadcast (Assign label after broadcast), an AI agent action, or the API.
Lists — "which mailing list is this person on?"#
Lists are named groups you build on purpose — for example, Diwali offer 2026 or Wholesale buyers. Add people with Bulk Actions → Add to List or at import. Broadcasts can include or exclude lists.
Custom fields — "what do we know about this person?"#
A custom field stores a value per contact: city, order_id, appointment_date, budget.
Fields get filled by: user input flows, WhatsApp Flows, imports (extra CSV columns become custom fields), the profile panel, or integrations.
Use them to personalise chatbot replies and broadcasts:
Hi #first_name#, your table for #party_size# is confirmed for #booking_date#. See you soon! 🍽️
Which one to use#
| Label | List | Custom field | |
|---|---|---|---|
| Answers | Is this person in group X? | Is this person on list X? | What is this person's X? |
| Example | VIP |
Diwali offer 2026 |
city = Tirur |
| Best for | Automatic tagging from flows | Hand-picked campaign audiences | Personalising & storing data |
Plan a handful of labels before you start (lead, customer, interest, location). A tidy label system makes every future broadcast easier.