We've got a ton of great merge tags to help you personalize and customize your campaigns and list forms. Use this cheat sheet as a quick reference for each merge tag available in MailChimp.

For more details on how to use merge tags in MailChimp, take a look at our Getting Started with Merge Tags article.

In this article:

Merge tags for campaigns

Use the merge tags in this section in any type of MailChimp campaign (Regular Ol', Plain-Text, A/B Split, and RSS-Driven).

Pulls in the link to your campaign archive page.

Displays the unique "id" parameter from your campaign archive URL.

Adds the MonkeyRewards badge to your campaign.

Adds a text-only version of the Rewards link.

Inserts links to translate your campaign archive into different languages.

Adds links for translating your campaign archive from one language, xx. All other available languages will be listed for your subscribers to choose from. See an example translation.

Displays the language code for a particular subscriber. For example, if your subscriber's language is set to English, the merge tag output will display the code en. Use this merge tag to show conditional content based on subscribers' language settings.

Displays the language for a particular subscriber. All language labels appear in English. For example, if your subscriber's language is set to German it will appear as German instead of Deutsch.

Displays the campaign send time or displays the current time if the campaign is still in Draft status. Date information displays based based on your settings in the My Defaults section of your account.

Use *|DATE:FORMAT|* to show the current date in a given format. For example, *|DATE:d/m/y|* where d is replaced by the day, m by the month, and y by the year. View a full reference of date options on the PHP website ( http://us3.php.net/manual/en/function.date.php). Not available for automation workflows.

Displays a list of links for your recent campaign archive pages. Campaigns listed are based on the list you've chosen on the Recipients step of the Campaign Builder. X is the number of campaigns to show. If a value for X isn't included, we'll pull in the 5 most recent campaigns by default.

Displays the campaign's subject line as specified on the Setup step of the Campaign Builder.

Creates a linked table of contents in your campaign.

Creates a table of contents in your campaigns as unlinked text.

Creates and records subscriber responses to a question using a rating scale of 1-10. See an example of adding a poll to a campaign.

Generates a unique QR code coupon for each of your subscribers. X is the description of the coupon, Y is the number of times it can be used, and Z is the size of the coupon.

Pulls in local events from Eventful into your content.

Pulls local Groupon deals into your content. Take a look at this article for instructions on how to add local deals to a campaign.

Feed merge tags

To quickly add RSS content to Regular Ol'Plain-Text, and A/B Split campaign types, use Feedblock merge tags. 

Merge tags for A/B Split campaigns

Runs an A/B split test campaign based on your newsletter content where X is either A (for Group A) or B (for Group B). See an example.

Merge tags for RSS-Driven Campaigns

You can quickly pull RSS content into RSS-Driven Campaigns with merge tags. Check out the RSS Merge Tags guide for a complete list, or skip to the type of tags you need:

Merge tags for personalization

Use these merge tags to display subscriber information in your campaigns, list forms, and response emails. The list below contains the most common merge tags used for personalization, but you're welcome to use any merge tags from your list!

Populates your subscriber's first name when available in your list.

Populates your subscriber's last name when available in your list.

Populates your subscriber's email address.

Merge tags for subject lines

These merge tags add details about your list, contact information, current date, etc. While they're perfect for subject lines, you can also use them in the content of your campaigns and list forms/emails too!

Displays the name of your list.

Displays the name of your company or organization as set in the Required Email Footer Content for your list

Displays the number of subscribers in your list in text format.

Displays the company or organization name listed under Administrator contact info in your MailChimp account.

Displays MM/DD/YYYY or DD/MM/YYYY based on your settings in the My Defaults section of your account.

Displays the current year. This is helpful if you have a copyright date on your campaign that you don't want to have to remember to change each year. 

Merge tags for footers

These merge tags grab essential information about your list from the Required Email Footer Content in your MailChimp account. While they're built for the footer of your MailChimp campaigns, they can be used anywhere in your campaign.

Gives your subscribers the opportunity to unsubscribe from your list. (Required by law and our Terms of Use.).

Pulls in your list's permission reminder.

Populates your subscriber's email address and is usually seen in the unsubscribe link:     

<a href="*|UNSUB|*">Unsubscribe</a> *|EMAIL|* from this list.<br />

Lets subscribers know which email address they'll be removing from your list if they click to unsubscribe.

Pulls in your mailing address and the "Add us to your address book" link that points to the vcard (.vcf) file with your address details.

Adds a standalone "Add us to your address book" link to your campaign.

Allows you to create a link in your campaign using this merge tag as the URL to point to your vcard (.vcf) file with your address details.

Pulls in the name of your list.

Creates a link to the About Your List page.

Pulls in the "id" parameter from your list's hosted forms. This is your list's unique ID.

Pulls in the website URL set in the Required Email Footer Content for this list.

Inserts your company/organization postal mailing address or PO Box as plain text.

Inserts your company/organization telephone number.

Inserts your company/organization name.

Inserts your default "Reply-To" Email set in the List name & defaults for this list.

Inserts the email address located in the Required Email Footer Content for this list.

Adds the URL for your list's hosted subscribe form. Learn More.

Gives your subscribers the opportunity to change their profile information. Learn more.

We'll insert the URL to your list's Forward to a Friend form.

Merge tags for the Confirmation "thank you" page and Final "welcome" email

These merge tags can be added to your lists's Confirmation "thank you" page and  Final "welcome" email. They will not work on other pages or emails that are part of the double opt-in process.

Displays the date your subscriber confirmed subscription to your list. Displays MM/DD/YYYY or DD/MM/YYYY based on your settings in the My Defaults section of your account.

Pulls in the date and time your subscriber confirmed subscription to your list. Output is based on your settings in the My Defaults section of your account.

Gives your subscribers the opportunity to unsubscribe from your list. (Required by law and our Terms of Use.)

Gives your subscribers the opportunity to change their profile information. Learn more.

Merge tags for list and account information

Use these merge tags to display essential details about your list, your company/organization, or account contact information.

Account information

Each of the merge tags below pull information from the Administrator contact information in your MailChimp account.

Displays the company or organization name.

Inserts the administrator address for the account on a single line.

Inserts the administrator address for the account on multiple lines.

 

Inserts the administrator telephone number for the account.

Inserts the administrator's website URL.

Displays the "u" parameter from your hosted MailChimp list forms.

List information

Displays the name of your list.

Displays the name of your company or organization as set in the Required Email Footer Content for this list.

Displays the number of subscribers in your list in text format.

Displays the 5 most recently sent campaigns for the list you're sending to. This is great if you want to show examples of recent campaigns to people who are interested in signing up for your list. See an example.

Displays clickable links to the archive pages for recent campaigns sent to list you're sending to. X is the number of campaigns to show. If a value for X isn't included, we'll pull in the 5 most recent campaigns by default.

Pulls in your list's permission reminder.

Pulls in your list's mailing address and the "Add us to your address book" link that points to the vcard (.vcf) file with your address details.

Adds a standalone "Add us to your address book" link to your campaign.

Allows you to create a link in your campaign using this merge tag as the URL to point to your vcard (.vcf) file with your address details.

Creates a link to the About Your List page.

Pulls in the "http://yourcompany.us1.list-manage.com/" portion of your hosted form URLs.

Pulls in the "id" parameter from your list's hosted forms. This is your list's unique ID.

Pulls in the website URL set under Required Email Footer Content for this list.

Inserts your list's mailing address as plain text.

Inserts your company/organization telephone number as set under Required Email Footer Content.

Inserts your default "Reply-To" Email under List Name and Defaults.

Inserts the email address located under Required Email Footer Content.

Adds the URL for your list's hosted subscribe form. Learn More.

Merge tags for subscriber counts

Use these merge tags to display the number of subscribers on your list. For the *|LIST:SUBSCRIBER_BADGE|* tags, each number represents a different badge style.

Displays a number. You can use this with a text blurb. For example, if you have 100 subscribers, and input "*|LIST_SUBSCRIBERS|* Happy Customers are currently enjoying our newsletters" in your campaign, we'll display "100 Happy Customers are currently enjoying our newsletters."

Displays the number of subscribers using an image rather than text. This style is a rounded rectangle with light blue header.

You can try out other designs too by using numbers 1-4 at the end of the tags so that they look like this:

*|LIST:SUBSCRIBER_BADGE1|*

*|LIST:SUBSCRIBER_BADGE2|*

*|LIST:SUBSCRIBER_BADGE3|*

*|LIST:SUBSCRIBER_BADGE4|*

Social and sharing merge tags

There are a variety of merge tags you can use to connect MailChimp with your social media accounts, including Facebook, Twitter, Tumblr, and more. 

Video merge tags

Embedded videos aren't supported in most email clients and are often stripped out completely. If you have videos you want to share, use our video merge tags for Blip.tv, YouTube, Vimeo, Vzaar, and Wistia. 

Learn how to add a video to a campaign with merge tags.

Conditional merge tag blocks

Conditional or dynamic merge tag blocks can be used in campaigns and in your list's Final "Welcome" Email. Smart, conditional, or dynamic merge tag blocks allow you to create dynamic content based on information from your list. You can build messages that present content that is unique to each subscriber. 

About Conditional Blocks

How Conditional Merge Tag Blocks Work

About Conditional (or Smart) Merge Tags

API merge tags

Use these merge tags when creating content via the MailChimp API.

Pulls in the "e" parameter from hosted form URLs, campaign tracking links, etc.

Pulls in the $member->email->unique_id; (API function). If used in a campaign, this tag will pull in your subscriber's unique id into the campaign content and can also be use to create unique links for subscribers.

Displays the unique "id" parameter from your campaign archive URL.

Content encoding merge tags

The content encoding class of merge tags class allows you to modify how the content inside your merge tags is displayed.

This tag handles merge field contents as raw HTML and makes no changes. This is a great way to pull in URL parameter values from your list and include them in your links. For example, if you have a merge tag, *|MYPARAMS|*, and a value includes something like ?id=1234&custom=awesome — in your link, use http://www.yourwebsite.com/*|HTML:MYPARAMS|* to keep the value of your merge tag as-is: http://www.yourwebsite.com/?id=1234&custom=awesome.

Encodes the value of your merge tag for inclusion in a URL. For example, if you have a merge field in your list, *|QUERY|*, and a value includes something like I love monkeys — in your link, use http://www.yourwebsite.com/*|URL:QUERY|* to URL encode the value like: http://www.yourwebsite.com/I+love+monkeys.

Changes the value of your merge tag to be title case (the first letter in each word is capitalized).

Changes the value of your merge tag to be all lower case.

Changes the value of your merge tag to be all upper case.

Merge tags for automation workflows

Use these merge tags to automatically display the numbered position of the email within the automation workflow, and more. They can be used in the subject line or body content for automation workflow emails. They should not be used in regular campaigns.

By default, the numbers will display as the digit (1, 2, 3, etc.). Add the following text before the end the merge tag to define how you want the number to display. As an example, you would type *|AUTOMATION:TOTALEMAILS(TEXT)|*. You do not need to replace the text in parentheses with a value.

(DIGIT) – displays a number (1, 2, 3, etc.)
(DIGITORDINAL) – displays a number as an ordinal (1st, 2nd, 3rd, etc.)
(TEXT) – displays the number as text (one, two, three, etc.)
(TEXTORDINAL) – displays the number as ordinal text (first, second, third, etc.)

Displays the total number of emails in the workflow.

Dispalys the current position of the email within the workflow.

Displays the next position in the workflow. 

Displays the previous position in the workflow.

Displays the subject line of the next email in the workflow.

Displays the subject line of the previous email in the workflow.

Was this article helpful?
What can we do to improve your experience with articles like this?
Thanks for submitting your feedback!
At this time, we are unable to reply to any responses, but we'll use this information to keep the site up-to-date.
Sorry, we were unable to submit your feedback. Please try again later. Thank you for your patience.

Related Articles