Custom fields for contacts

Custom fields store additional data on each contact — company, location, subscription tier, birthday, or anything else worth knowing about your audience — beyond Letterhead’s built-in profile fields. Use those values to build segments and personalize newsletter content with personalization tags.

How custom field values get filled

• Signup forms — answers readers provide in extra fields when subscribing through your signup form save directly to their contact record. See Save signup form responses to contact records.
• CSV import — if your CSV includes columns matching existing custom field names, Letterhead populates those values automatically during import. You can’t create new fields via import.
• API and Zapier — update field values programmatically through the Zapier integration or the Letterhead API.
• Manually — edit values on any contact from their profile.

You can create custom fields for your account yourself — for example, a field to store a subscriber’s birthday. From your Audience page, open the Settings tab, find Custom Fields, and click Add field to name it and choose its type.

Use custom fields in segments

Custom fields appear as conditions when you create or edit a segment — for example, city equals New York — and can be combined with tags using ANY/ALL logic.

Use custom fields in email content

Reference a field in your newsletter with a personalization tag, optionally with a default value for contacts missing the field.

Reserved system fields

Letterhead maintains read-only system fields prefixed __lh. — such as the subscriber’s mailbox provider and engagement state. You can segment on these fields but can’t edit or delete them.

Related

• What are audience profile fields? — the full list of built-in fields.
• Working in Audience