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.
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.

