Skip to main content
Custom fields let you store any data point that matters to your business directly on contact records. Whether you need to track a client’s shirt size, membership tier, preferred language, intake date, or any other business-specific attribute, custom fields extend the standard contact record to fit your workflow. Custom field values appear in the Additional Info tab of every contact record, are available for use in smart list filters, workflow conditions, and email/SMS personalisation tags.

​
Types of custom fields

The HoopAI Platform supports the following custom field types for contacts:
Field typeDescription
TextSingle-line free text entry
Large textMulti-line text area for longer content
NumericalNumbers only — useful for amounts, counts, or scores
PhonePhone number with country-code formatting
MonetaryCurrency value with decimal support
Date pickerCalendar date selector
Date and timeDate with hour and minute precision
CheckboxTrue/false toggle
Single optionsRadio button — choose one value from a defined list
Multiple optionsCheckbox group — choose one or more values from a list
DropdownSelect a single value from a dropdown list
Radio selectSame as single options with a different display style
File uploadAllows file attachments (documents, images)
SignatureCaptures a digital signature from the contact

​
Creating a custom field

1

Open Custom Fields settings

Navigate to Settings > Custom Fields. The Custom Fields page lists all existing fields organized by object type.
2

Select the Contacts object

Make sure the Contacts tab is selected so the new field is applied to contact records.
3

Add a new field

Click + Add Field to open the field creation panel.
4

Configure the field

Fill in the following:
  • Field label — the name displayed on the contact record and in forms
  • Field key — a unique identifier used in automations and API calls (auto-generated from the label, but can be customised)
  • Field type — select from the list above
  • Placeholder text (optional) — hint text shown inside the field before a value is entered
  • Options (for single/multiple option and dropdown types) — enter each selectable value on a new line
5

Save the field

Click Save. The field is immediately available on all contact records under the Additional Info tab.
Use descriptive field labels that are clear to every team member — for example, “Intake date” rather than “Date1” or “Preferred contact method” rather than “Method.”

​
Organising custom fields into groups

Group related custom fields together to keep the Additional Info tab clean and navigable.
1

Create a group

On the Custom Fields settings page, click + Add Group. Enter a name for the group (e.g., “Membership details” or “Intake information”).
2

Assign fields to the group

Drag existing fields into the group, or set the group when creating a new field using the Group dropdown in the creation panel.
3

Reorder groups and fields

Drag group headers and individual fields to reorder them. The order in Settings determines the display order on the contact record.

​
Viewing and editing custom field values on a contact

1

Open the contact record

Navigate to Contacts > Smart Lists and click a contact’s name.
2

Open the Additional Info tab

Click the Additional Info tab in the left panel. All custom fields are displayed here, grouped if you have created field groups.
3

Enter or update a value

Click any custom field to edit its value. Changes are saved automatically when you click outside the field or press Enter.

​
Using custom fields in smart lists

Custom field values are available as filter conditions in Smart Lists.
  1. Open Contacts > Smart Lists and click Advanced Filters
  2. Select Custom Fields from the field category list
  3. Choose the specific custom field
  4. Select a condition (equals, contains, is empty, greater than, etc.)
  5. Enter the value to filter by
  6. Click Apply
This lets you create segments like “All contacts with Membership Tier = Gold” or “All contacts whose Intake Date is in the last 30 days.”

​
Using custom fields in emails and SMS

Reference custom field values in message templates using personalisation tags:
  • In the message editor, click Custom Values or the personalisation tag icon
  • Locate your field under Contact > Custom Fields
  • Insert the tag, which appears as {{contact.custom_field_key}}
If the field has no value for a particular contact, the tag renders as blank (or the fallback value you configure).

​
Editing and deleting custom fields

To rename or modify a field, click the pencil icon next to it on the Custom Fields settings page.
Deleting a custom field permanently removes the field and all values stored in it across every contact record. This cannot be undone. Archive or rename fields instead of deleting them if there is any chance you will need the data later.

​
Frequently asked questions

There is no strict limit on the number of custom fields. However, keeping the list focused and well-organised improves usability and system performance.
Yes. When building a form or survey, select any contact custom field as the destination for a form element. Submitted values are written directly to the contact record.
Default values are not set at the field level. You can use a workflow action to pre-populate a custom field when a contact is created or reaches a certain stage.
Yes. During the import wizard field-mapping step, map any CSV column to a custom field. The field must already exist in Settings before importing.
Last modified on March 5, 2026