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 becomes company), 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:

TypeDescriptionUse Case
TextFree-form text inputNames, descriptions, notes
NumberNumeric values onlyAges, quantities, scores
DateDate picker inputBirthdays, join dates, expiration dates
Date & timeDate and time pickerEvent 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

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:

FieldTypeDescription
EmailTextSubscriber's email address (required)
NameTextSubscriber's full name
StateTextSubscription status (Subscribed, Not confirmed, and so on)
Added AtDate & timeWhen the subscriber was added
EngagementNumberHow actively the subscriber reads your emails
Default fields cannot be modified or deleted as they are essential for core newsletter functionality.

Important Considerations

Reserved Field Names: You cannot create custom fields with names or tags that conflict with default fields or system-reserved values like 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.
Field Deletion: Deleting a custom field permanently removes all data stored in that field for every subscriber. This action cannot be undone.
Plan Field Strategy: Consider your long-term data needs when creating fields. Fields used for segmentation or personalization should have consistent naming and tagging conventions.

© 2026 Yaplet. All rights reserved.