Skip to main content
Custom fields let you store your own attributes on subscribers, then use them in segments, campaigns and automations.

Create a custom field

In Custom fields, open the field builder, pick a type, and configure its properties:
PropertyNotes
Display nameThe human-readable label.
Field keyUsed in placeholders as {{custom.<key>}}. Lowercase letters, digits and underscores only.
DescriptionOptional explanation.
Default valueOptional value used when none is set.
Required when editing subscribersMakes the field mandatory in the subscriber form.
OptionsFor Single choice and Multiple choice fields.
You can also set validation: min/max length, a regex pattern, min/max value or step, depending on the type.

Field types

TypeUse for
Text / Long textShort or multi-line text.
Number / DecimalWhole or fractional numbers.
Date / Date & timeDates, with or without a time.
Yes/NoBoolean values.
Single choicePick one option from a list.
Multiple choicePick several options.
URL / Email / PhoneValidated formats.
ComputedA value derived from other fields via a logic editor.

Using a field in content

Reference a field in email content and merge tags with its key:
Hi {{custom.first_name}}, your plan is {{custom.subscription_tier}}.
Unknown or misspelled placeholders are flagged by the campaign pre-send analysis and can block a send. Double-check field keys.

Scope and status

  • Scope: fields are either System (built in) or User-defined (created by you).
  • Status: Active or Archived. Archive a field to retire it without deleting data; you can unarchive or delete it later.