> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatflows.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Fields

> Save extra details on each customer, like birthday, preferred language or company name, and use them across ChatFlows.

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

![Custom Field form showing field name, type selector, and field options](</core-setup/img/custom field-form.png>)

Image shows the New Custom Field form.

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

> [!NOTE]
>
> 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:

| Type | Use it for | Example |
| - | - | - |
| Text | A short line of text | Company Name |
| Text Area | Longer text over many lines | Special instructions |
| Email | An email address | Billing email |
| URL | A website link | Company website |
| Phone | A phone number | Office number |
| Number | A number | Contract value |
| Dropdown | Pick one choice from a list | Industry |
| Radio | Pick one choice, all shown at once | Preferred language |
| Checkbox | Pick more than one choice | Interested products |
| Date | A calendar date | Renewal date |
| Time | A time of day | Preferred call time |
| Color | A color | Brand color |
| Toggle | A simple yes or no | VIP customer |

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

> [!WARNING]
>
> 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](https://docs.chatflows.io/contacts/managing-contacts.md).
* 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](https://docs.chatflows.io/messaging/merge-fields.md).
* When [importing contacts](https://docs.chatflows.io/contacts/import-export.md), you can match a column in your file to a customer field.
* When a customer fills a [WhatsApp Form](https://docs.chatflows.io/messaging/whatsapp-forms.md), 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

> [card] [Merge Fields](https://docs.chatflows.io/messaging/merge-fields.md)
>
> Use customer fields to personalize your messages.

> [card] [Import & Export](https://docs.chatflows.io/contacts/import-export.md)
>
> Fill customer fields while importing contacts.

> [card] [WhatsApp Forms](https://docs.chatflows.io/messaging/whatsapp-forms.md)
>
> Save form answers into customer fields.

> [card] [Campaigns](https://docs.chatflows.io/messaging/campaigns.md)
>
> Send personalized messages to many contacts.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.