Custom fields and custom variables
Custom fields add your own information to every contact, such as "City", "Customer ID" or "Plan".
- Who can use this
- Account owner, Manager
Custom fields add your own information to every contact, such as "City", "Customer ID" or "Plan".
Custom fields add your own information to every contact, such as "City", "Customer ID" or "Plan". Custom variables are fixed values for your whole workspace, such as your support email, that you can drop into messages. Both can be used as {variables} in messages.
You need access to Settings to see these pages. Agents see and fill in custom fields on the contact's profile in the inbox. Fields set to Manager Only are hidden from agents.
Add a custom field
The Field Name is made from the label automatically.
A value typed on a contact, set by a chatbot, sent through the API or imported is then added to the options automatically.
Add a custom variable
Use only lowercase letters, numbers and underscores.
Click the copy button on the row to copy the placeholder, for example {company_name}.
Use variables in a message
Variables you can use:
| Variable | Becomes |
|---|---|
{contact.name} | The contact's name |
{contact.phone_number} | The contact's phone number |
{staff.name} | The name of the agent sending the message |
{field_name} | This contact's value for that custom field |
{variable_name} | The value of that custom variable |
Do it with Copilot
(crm_list_custom_fields)
Do it with Copilot
(crm_create_custom_field)
Do it with Copilot
(crm_update_custom_field)
Do it with Copilot
(crm_delete_custom_field)
Creating and changing fields is for managers only. Deleting a custom field always needs a person's approval in the panel.
| What you see | Why | What to do |
|---|---|---|
| "Field label is required" | The label is empty. | Enter a label. |
| "Select fields must have at least one option" | A Dropdown, Multi-Select or Radio field has no options. | Add at least one option. |
| "Option label and value are required" | An option is missing its label or value. | Fill in both. |
| "Variable name should contain only lowercase letters, numbers, and underscores" | The variable name has capitals, spaces or symbols. | Use a name like support_email. |
| "Name and value are required" | A custom variable is missing its name or value. | Fill in both. |
| An agent cannot see a field | The field is Manager Only. | Change its visibility to Visible to All. |
| A variable was sent blank | The contact had no value and no fallback was given. | Add a fallback before sending, or fill in the contact's field. |