Custom fields are pieces of data that you send us about your participants, above and beyond the minimum required to power your program. You can send us all kinds of information in the form of a custom field, such as:
You can build program rules that use the information from custom fields to trigger goals and actions. This custom information can also be referenced if you place your participants into segments.
Related to custom fields are calculated fields. Unlike custom fields, which just record the information you send us, calculated fields allow you to perform different types of calculations with the data you send us, and then store the resulting value as a custom field that’s available on the participant’s profile.
Custom fields can be sent to us when you upload a user import file or via UTT, API, SDK, or another integration method.
Any custom fields you send us need to meet a few requirements for field names and values.
Up to 64 characters
Only alphanumeric characters, dashes, and underscores are accepted (letters must be unaccented)
Case sensitive.
customFieldName
is treated as distinct fromcustomfieldname
Supports string, number, Boolean, and null types
Max string value of 1024 characters
Dates must be formatted as a unix timestamp in milliseconds
Maximum of 100 fields can be added/updated per request
Setting a custom field for a user to
null
will remove the field for that user.
You can include custom fields whenever you create, update, or upsert users, regardless of the method you use to send us the data.
You can include custom fields when importing new users or updating existing users in bulk. See our documentation on Import Participants in Bulk for instructions.
Custom fields can be included when using our GraphQL API methods or Rest API endpoints that create, update, or upsert users. Similarly, they can also be included when using UTT or our mobile options to create, update, or upsert users from within your application.