This article is part of a series of articles about personalizing emails. You can check out other ways to personalize your messages.

Merge fields can be used to personalize message content. They can be added anywhere in emails, including the subject line and pre-header text.


Frequently used fields can be added using the "Merge field" selector from the message editor toolbar. The most common merge field is the first name used in the greeting line.

The merge field in your message will look like this:

Hello {fname},

Default first name

On the account settings page you can enter a default "first name" value to be used if a contact doesn't have a first name field in the database.

Additional merge fields

Other, less common fields can be added by typing the merge fields in the message using the syntax below:

Contact fields

Email: {email}
First name: {fname}
Last name: {lname}
Company: {company}
Primary phone: {phone}
Secondary phone: {phone2}
Mobile phone: {cell}
Province or state: {province}
Country: {country}
City: {city}
Postal or zip: {postal}
Title: {title}
Address line 1: {addr1}
Address line 2: {addr2}

Custom fields


For example if your custom field is called "StudentID" then the merge field becomes {@my-StudentID}

Pro tip: For "note" type custom fields you can use {@my-fieldname|html} to parse line breaks (<br> tags) as the content of the field is merged into your message.

You can read more about custom fields here.

Contact IDs

Envoke external contact ID {eid}
Remote ID {remote_id}

More information about contact IDs.

{@pref-0} Link to the preferences page
{@pref-1}/2 One-click (instant) unsubscribe
{@pref-1}/3 Consent checkbox pre-checked
{@pref-1}/4 One-click (instant) provide consent
{@pref-1}/fr Preferences page, default French wording

See this article for details about the Consent and Preferences page including options to customize the unsubscribe link.

Email messages

View online link: {@msg-url}
Message name: {@msg-name}
Message ID: {@msg-id}
Subject line: {@msg-subject}

This only applies if the mandatory communication feature is enabled.

Mandatory message reason: {@msg-mandatory_reason}


Year (four digits, for example: 2019): {@sys-timestamp|Y}
Month (full name, for example: May): {@sys-timestamp|F}
Month (numeric, for example: 10): {@sys-timestamp|m}
Day (numeric, for example: 23): {@sys-timestamp|d}

Social media

Facebook: {@social-facebook|url}
Twitter: {@social-twitter|url}
LinkedIn: {@social-linkedin|url}
Instagram: {@social-instagram|url}
Pinterest: {@social-pinterest|url}
YouTube: {@social-youtube|url}
Vimeo: {@social-vimeo|url}
RSS: {@social-rss|url}
TripAdvisor: {@social-tripadvisor|url}

Test and preview

Populate the relevant fields in your own contact record -- that contact record is used for previews. Your contact record is the one associated with your user login.
For example if your user login is associated with and you want to test the merge field for company name then be sure the company field is filled for the record.

Did this answer your question?