All the Merge Tags Cheat Sheet

This feature requires Manager user level or higher.

MailChimp offers merge tags for all kinds of dynamic information. Paste a merge tag into any campaign to personalize or specify special content. The list below outlines all of the tags available to you. 

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

Merge Tags for Campaigns

Use the merge tags in this section in any type of MailChimp campaign.

Creates the URL to your campaign archive page.

Displays the unique ID 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 a list of links to translate the content in your campaign. Replace xx with the code for the language your campaign is written in, and we'll display other available languages.

For example, for an English campaign, use *|TRANSLATE:en|* and we'll include a list of links to all supported languages except English.

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 plain-text  language for a particular subscriber. All languages are written English, so if your subscriber's language is set to German we'll display "German" instead of Deutsch.

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. This merge tag won't function as expected in Automation workflows, because the date will remain static regardless of the day the email sends to a subscriber.

Displays a list of links to recent campaigns on your archive page for the list indicated on the  Recipients step of the Campaign Builder. Replace  X with the number of campaigns to show. If you leave X blank, it will show five. 

Displays the campaign's subject line indicated 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 plain-text.

Creates a poll to record subscriber ratings of 1-10. Learn how to add a poll to your campaign.

Generates a unique QR code coupon for each subscriber. For each variable, input the following.

  • XXX: description of the coupon
  • YY: the number of times it can be used
  • ZZ: the size of the coupon

Insert local Groupon deals into your content. 

Feed merge tags

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

Merge Tags for RSS-Driven Campaigns

Pull RSS content into RSS-Driven Campaigns with merge tags. You'll use different tags for different tasks. Use preformatted RSS tags as a simple solution, or customize your feed using channel and item tags.

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!

Inserts your subscriber's first name if it's available in your list.

Inserts your subscriber's last name if it's available in your list.

Inserts your subscriber's email address.

Merge Tags for Subject Lines

These merge tags add details about your list, contact information, current date, and more. They're commonly used in subject lines but can be used in regular campaigns, list forms, and response emails too. 

Inserts the name of your list.

Inserts the name of your company or organization that's listed in the Required Email Footer Content for your list

Inserts the number of subscribers in your list in plain-text.

Inserts the company or organization name listed under Primary Account Contanct 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 great if you include a copyright date in your campaign, because it will update automatically every 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.).

Inserts your list's permission reminder.

Inserts your subscriber's email address. This is commonly used in the unsubscribe link, which helps them know who will be removed if they click the Unsubscribe link.     

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

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

Inserts an "Add us to your address book" link to your campaign.

Inserts a text URL that points to your vcard (.vcf) file of your address details. Use this as a link's Web Address to create a linked version.

Inserts the name of your list.

Creates a link to the About Your List page.

Inserts your list's unique ID from your list's hosted forms. 

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

Inserts your company or organization postal mailing address or P.O. Box as plain text.

Inserts your company or organization telephone number.

Inserts your company or 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.

Inserts the URL for your list's hosted signup form.

Inserts a link to the subscriber's update profile page. 

Inserts the URL to your list's Forward to a Friend form.

Merge Tags for Confirmation Page and 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

Use Conditional Merge Tag Blocks

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.

Displays 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 articles like this?

Tagged

Technical Support