support center

Custom fields

What are custom fields?

Custom fields let you store arbitrary data on leads. They can be used for many different purposes.

You can sync your internal database with our system, label leads in a specific industry/vertical, assign leads to particular reps, store some meta data that could be relevant during a sales call, etc. The exact use case depends on what you're trying to accomplish, but the flexibility of our custom fields combined with their smart layer of validation empowers you to store all the relevant data in one place.

Custom fields are scattered all around Close.io, but there are main three main ways in which you interact with them:

  1. You view and edit custom field values on the lead page:

  2. You search for specific custom field values (or value ranges) on the search page:

  3. You create/rename/merge/remove custom fields and pick their types on the Customizations Settings page:


How do I create a custom field?

The easiest way to set up new Custom Fields in Close.io is to use the Customizations Settings page (click on your name/picture in the top-right corner and choose Settings -> Customizations). Custom Fields are located near the bottom of the Customizations page. You can create, rename, merge, remove, and change types of custom fields from that page.

After your custom fields are created, you can start populating their values for each lead on the lead page. Simply click the "+ add" button next to "Custom Fields" in the bottom-left of a lead page.

From there, you will be able to add values to existing fields as well as create brand new fields.

How do I search for leads matching a specific custom field value?

Two ways:

From a lead page, hover over a custom field and click the magnifying glass icon to see other leads with the same custom field value.



From the Leads search result page, expand and use the "Custom Fields" section in the right sidebar.

What types of custom fields are there?

For convenience and easier searching and reporting, we provide you with a few different types of Custom Fields:

  • Text: plain text field with no validation or structure.
  • Choices: a dropdown of predefined choices. Admins can set up all the possible choices this field can contain ahead of time.
  • Number: a text field that only accepts numeric values (including numbers with decimal places).
  • Date: a text field that only accepts a date. In edit-mode you'll get a nice date picker widget and in read-mode the date will be formatted.
  • Date/Time: a field that requires both a date and a time. In edit-mode you'll get a nice date and time picker widgets and in read-mode the date and time will be formatted.
  • User: a dropdown containing all the users who are active in your organization.
  • Hidden: a field that's never displayed in the UI, but can be useful for API integrations. Accepts any data type from JSON, including lists and objects.

Can I change the type of an existing custom field?

Yes, you can. Head over to Settings -> Customizations and click on an "Edit" button next to the custom field you're interested in. Choose the desired new type from the "Type" dropdown. Hidden custom fields are the only ones that can't be changed (however, they can still be renamed or deleted).

How can I change my Text/Choices custom field to the User type?

Most importantly, you need to make sure that all the values you'd want to keep match exact full names (or IDs) of the users in your organization. If that isn't the case, you will need to rename them first (e.g. using our Bulk Edit feature). After all the values have correct names, go to the Customizations page, edit your custom field, and change its type to User:

See the article about renaming custom field choices if some of your choices don't match the exact user names. You will lose any values that don't exactly match full names or IDs of the users in your organization. Before initiating this change, please convert any existing values/names to match the full names in their Close.io account.

What happens if I remove a user from my organization and they were assigned to some leads via a User type custom field?

The leads remain assigned to that user. You can search for them using "custom.Field Name":"Removed User Name".

Can I search, sort, and filter leads by any custom field value?

Hidden fields are not searchable at all. Text/Choices custom fields support exact search only (e.g. custom.Industry:IT), whereas Number/Date/Datetime fields can be sorted by, and filtered by a range of values (e.g. custom.Number > 0 custom.Number < 100 sort:-custom.Number).

Can anybody create, edit, merge, and delete custom fields?

No, these actions are restricted to organization admins only.

How do I rename a choice custom field?

Checkout this help article: https://help.close.io/customer/portal/articles/1831956-rename-a-choice-custom-field

Can I create new custom fields straight from the lead details page?

Yes, if you're an admin.