Custom Fields | Yaplet

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.

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
Tag: Unique identifier used to reference the field in templates and filters

Save and Use

After creating the field, it will be available for all subscribers and can be populated through imports or individual editing.

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
Datetime	Date and time picker	Event timestamps, scheduled reminders

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

Rename Field

Update the display name or tag of an existing field. 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.

Delete Field

Remove a custom field permanently. This action deletes all data stored in that field for all subscribers.

Default Fields

Your system includes several default fields that are automatically available for all subscribers:

Field	Type	Description
Email	Text	Subscriber's email address (required)
Name	Text	Subscriber's full name
State	Text	Subscription status (VERIFIED, UNVERIFIED, etc.)
Added At	Datetime	When the subscriber was added

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.

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.