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}
Link to the consent and preferences page
{@pref-0} Link to the preferences page in contact's selected language.
{@pref-0}/en Link to the preferences page in English.
{@pref-0}/fr Link to the preferences page in French.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|noeid}
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
Use the Preview as... option in the email editor to see the content that a contact on your list will see after the merge fields are in place.