Using contact fields in emails
With contact fields you add recipient data to your emails, such as the first name in the salutation or the name of the associated account manager.
What are contact fields?
Contact fields are fields you have imported with your contacts, or that have come in automatically via a webshop integration. Examples:
- First name
- Last name
- Email address
- City
- Date of birth
Go to All contacts in the left menu and select a contact to see which fields are in your account. All fields are also listed under Settings → Manage database.
Adding extra contact fields
You can add extra fields via:
- Manual entry: adding individual contacts.
- CSV and Excel import: uploading large lists.
- Webhook: importing contacts from forms or pop-ups, or syncing with your systems.
- Webshop integration: automatically importing via WooCommerce, Shopify, Magento 2, Lightspeed, or a custom webshop.
- Manage database: under Settings → Manage database you can create your own contact field using New field.
Adding contact fields in the editor
- Open an email under Drafts or in an Email automation.
- Type
@in the text editor. The list of available fields opens. - Keep typing to filter the list; capitalization doesn't matter. If no field matches, the list disappears.
- Choose a field with the mouse, or use the arrow keys and Enter. The field appears as
{first_name}with a purple background.
In addition to your contact fields, two fields are always available in the list: {company_name} (your company name) and {year} (the current year). In fields without a list, such as a button label, you can also type the field name between curly braces yourself, for example {first_name}. Pay close attention to the spelling: a field name that doesn't exist will appear literally in your email.
You can also use contact fields in the Sender name, the Subject, and the Preheader: type @ there as well. In the Sender email field this is not possible, as only letters, numbers, periods, underscores, and hyphens are allowed there.
What if a contact has no value?
Set a default value (fallback) for every field you use — see below. If a contact has no value and there is no default value, that contact will not receive the email. The pre-send check will warn you about this, but will not prevent the email from being sent.
