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.

Usage

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

{@my-NAME}

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}

Dates

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

You can preview and test merge fields as any contact in your database like this:

(an easier, more elegant "preview as..." solution is on our 2022 development roadmap)

Did this answer your question?