Custom Fields
Custom fields allow you to extend subscriber data beyond the basic email and name fields, enabling personalized communication and advanced segmentation.
Understanding Custom Fields
Custom fields let you store additional information about your subscribers, such as:
- Company names or job titles
- Geographic locations or time zones
- Purchase history or subscription preferences
- Custom identifiers or membership levels
These fields can be used in email templates, filtering subscribers, and creating targeted segments.
Creating Custom Fields
Access Fields Management
Navigate to Marketing → Newsletter → Subscribers → Fields to view all custom fields. The table lists each field's Name, Type, Merge tag (with a copy button) and when it was Added.
Create a New Field
Click the Create field button to add a new custom field to your subscriber data.
Configure Field Properties
Set the following properties for your new field:
- Name: Display name for the field (shown in tables and forms)
- Type: Data type that determines how the field behaves — pick one of the cards (see below)
- Merge tag: Unique identifier used to reference the field in templates and filters, shown between double braces as
{{ company }}. It fills in from the name as you type (Company becomescompany), or you can type your own using only letters, numbers and underscores
Save and Use
Click Create field. The new field is available for all subscribers and can be filled in on the subscriber page, by import or from a signup form.
Field Types
Choose the appropriate field type based on the data you'll store:
| Type | Description | Use Case |
|---|---|---|
| Text | Free-form text input | Names, descriptions, notes |
| Number | Numeric values only | Ages, quantities, scores |
| Date | Date picker input | Birthdays, join dates, expiration dates |
| Date & time | Date and time picker | Event timestamps, scheduled reminders |
Each card in the type picker adds a one-line hint: Text is "Any words, like a company or city", Number is "Numbers you can compare, like age or points", Date is "A day, like a birthday" and Date & time is "A day and a time, like a last purchase". The type cannot be changed once the field exists.
Number fields always hold real numbers, whichever way a value arrives — the edit page, an import, the API, an automation or the AI. "12" sent as text is saved as 12, which is what lets More than and Less than filters compare them as numbers (10 counts as more than 9).
Field Tags and Templates
Field tags are unique identifiers that allow you to reference custom field data in email templates and other dynamic content — including the campaign subject line and preheader. Every tag accepts an optional fallback for contacts with no stored value, e.g. {{ firstName | there }} — see the Email Builder page for details.
Dear {{ firstName }}, Thank you for your interest in {{ company }}. Your subscription level is: {{ membershipLevel }} Best regards, The Team
{
"email": "[email protected]",
"firstName": "John",
"company": "Acme Corp",
"membershipLevel": "Premium"
}
Managing Custom Fields
Edit Field
Click a field's name or its Edit button to update the display name or merge tag. Changing the display name keeps all stored data. Changing the tag does not — existing values stay stored under the old tag, so the field shows up empty afterwards, and emails that already use the old tag stop filling it in until you update them. The three-dot menu also holds Copy merge tag.
Delete Field
Choose Delete field in the three-dot menu to remove a custom field permanently. This action deletes all data stored in that field for all subscribers, and emails that still use its tag will show the tag itself instead of a value.
Default Fields
Your system includes several default fields that are automatically available for all subscribers. They are listed under Default fields below your own fields, each with a Built-in badge and its merge tag:
| Field | Type | Description |
|---|---|---|
| Text | Subscriber's email address (required) | |
| Name | Text | Subscriber's full name |
| State | Text | Subscription status (Subscribed, Not confirmed, and so on) |
| Added At | Date & time | When the subscriber was added |
| Engagement | Number | How actively the subscriber reads your emails |
Important Considerations
subscribeURL or unsubscribeURL. The tags of the activity fields Yaplet fills in itself are reserved too — Email provider, Last active, Last opened, Last clicked, Clicks, Emails received and Last emailed use isp, last_active_at, last_opened_at, last_clicked_at, click_count, emails_received and last_emailed_at.