Skip to main content
Customer fields let you store your own details on every contact, beyond name and phone number. For example: “Company Name”, “Contract Value”, “Preferred Language”, or “Birth Date”. Once you create a field, it appears on the Custom Fields tab whenever you add or edit a contact. You can also show it as a column in your contact list and use it to personalize messages.

Creating a customer field

1

Open Setup → Customer Fields

Click Setup in the sidebar, then Customer Fields.
2

Click Add Custom Field

A form opens on the right side of the screen. It has two tabs: Basic and Options.
3

Fill in the Basic tab

Enter a Label — this is the field name your team will see, such as “Company Name”. Then pick a Type that matches the data, such as Text, Number, or Date.The other fields on this tab are optional. Each one is explained below.
4

Click Next to open the Options tab

If you chose Dropdown, Radio, or Checkbox, add the choices here. You must add at least one choice before saving.For other types, this tab lets you set optional limits, such as a minimum and maximum for numbers or an earliest and latest date.
5

Click Save

Your field is ready. It now appears on the Custom Fields tab whenever you add or edit a contact.
Make a field Required only if every contact truly needs it. Once it is required, you must fill it every time you save any contact.

Field types

Pick the type that matches your data:

Options for each type

When you click Next, the Options tab changes based on the type you picked:
  • Dropdown, Radio, Checkbox — add your choices here. At least one choice is required.
  • Text, Text Area — set a minimum and maximum length. Optional.
  • Number — set a minimum and maximum value. Optional.
  • Date — set the earliest and latest date allowed. Optional.
  • Checkbox — also set how many choices must be picked. Optional.
  • All other types — nothing to set here. Just click Save.

Editing and managing fields

Your customer fields appear in a list on the same page. From here you can:
  • Edit — open the row menu and click Edit to change the label, type, or options. The Slug cannot be changed.
  • Turn on or off — use the Active toggle on each row. An inactive field is hidden from the contact form and from message personalization, but the saved values are kept. Turn it back on and everything returns.
  • Delete — open the row menu and click Delete to remove the field everywhere.
Deleting a customer field cannot be undone. The field disappears from every contact. If you are not sure, turn the field off with the Active toggle instead.

Where customer fields appear

After you create a field, it works across ChatFlows:
  • On the Custom Fields tab when you add or edit a contact.
  • As a column in your contact list, if Show in Table is on.
  • As a personalization token in messages and campaigns — you pick it from the token list, no typing needed. See Merge Fields.
  • When importing contacts, you can match a column in your file to a customer field.
  • When a customer fills a WhatsApp Form, their answers can be saved into customer fields.

Tips

  • Create your customer fields before importing contacts, so you can fill them during the import.
  • Use Dropdown instead of Text when the answers come from a fixed list. It keeps the data clean.
  • Turn on Show in Table only for the fields you check often, so your contact list stays easy to read.

What’s next

Merge Fields

Use customer fields to personalize your messages.

Import & Export

Fill customer fields while importing contacts.

WhatsApp Forms

Save form answers into customer fields.

Campaigns

Send personalized messages to many contacts.
Last modified on November 17, 2026