Add custom fields to contacts and companies

Store details like plan or role on contacts and companies, edit them in place, and use them as fill-ins in your replies.

Updated
On this page

Custom fields keep facts about people and companies, like plan, role or renewal date. Your team sees them next to every chat.

Add a field

  1. Go to Settings → Fields. Owners and admins can add fields.
  2. Under Contact fields or Company fields, click New field.
  3. Enter a Name (up to 60 characters).
  4. Pick a Type: Text, Number, Date, Yes or no, or List of choices (one per line). You can't change the type later.
  5. Click Save.

You can have up to 50 fields for contacts and 50 for companies. Each shows its key, like {{contact.plan}}. Your site can send that same key when you identify users. A name like "Plan" becomes the key plan.

Owners and admins can also add a field from a contact's profile with Add field, or use the pencil on an existing one.

Fill them in

Anyone on the team can edit values in place on a contact or company. Values from your site fill automatically.

TypeAccepts
TextUp to 500 characters
NumberA number
DateA date
Yes or notrue, yes, 1 or false, no, 0
List of choicesOne of the choices

Use them in replies

Add them to canned replies with fill-ins like {{contact.plan}}. Add | fallback for when it's empty.

Delete a field

Delete removes it from every contact and company, with what's saved in it. This can't be undone.

Questions

Why does my site's data create a field? Unknown keys can create a new field automatically, up to the 50 limit for each.

"There's a field with that key." Pick a different name.

Did this help?

Related articles