Idea Transcript
Knowledge Base
Merge Tags for Campaigns Merge Tags for RSS Campaigns Merge Tags for Personalization Merge Tags for Subject Lines Merge Tags for Footers Merge Tags for Confirmation Page and Welcome Email Merge tags for list and account information Merge tags for subscriber counts Social and sharing merge tags Video merge tags Conditional merge tag blocks API merge tags Content encoding merge tags Merge tags for Automations Merge Tags for Product Recommendations
All the Merge Tags Cheat Sheet Updated: Dec 15, 2017
MailChimp offers merge tags for all kinds of dynamic information. Paste a merge tag into any campaign to add personalized or dynamic 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. *|ARCHIVE|*
Creates a View this email in your browser link to your campaign page. *|CAMPAIGN_UID|*
Displays the unique ID for your campaign. *|REWARDS|*
Adds the MonkeyRewards badge to your campaign. *|REWARDS_TEXT|*
Adds a text-only version of the Rewards link. *|MC:TRANSLATE|*
Inserts links to translate your sent campaign into different languages. *|TRANSLATE:xx|*
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. *|MC_LANGUAGE|*
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. *|MC_LANGUAGE_LABEL|*
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. *|DATE:X|*
Use *|DATE:X|* to show the current date in a given format. Replace X with the format of your choice. 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. The merge tag will display as the date the email is sent to the subscriber. *|LIST:RECENTX|*
Displays a list of links to recent campaigns the list indicated. Replace X with the number of campaigns to show. If you leave X blank, it will show five. *|MC:SUBJECT|*
Displays the campaign's subject line. *|MC:TOC|*
Creates a linked table of contents in your campaign. *|MC:TOC_TEXT|*
Creates a table of contents in your campaigns as plain-text. *|MC_PREVIEW_TEXT|*
Use this merge tag to generate preview text in a custom-coded campaign. Insert *|MC_PREVIEW_TEXT|* just after the opening < body > tag in your HTML. To ensure the preview text isn’t visible in the body of your campaign, wrap the merge tag in a hidden < span > element. Locate or add < style type= "text / css" > < /script > to your HTML, and add this code to the "style type" value: .mcnPreviewText{display: none !important;}
After the opening < body > tag, add: *|MC_PREVIEW_TEXT|*
*|POLL:RATING:x|* *|END:POLL|*
Creates a poll to record subscriber ratings of 1-10. Learn how to add a poll to your campaign.
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 Campaigns Pull RSS content into RSS 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. Preformatted RSS 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 can use any merge tags from your list. *|FNAME|*
Inserts your subscriber's first name if it's available in your list. *|LNAME|*
Inserts your subscriber's last name if it's available in your list. *|EMAIL|*
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. *|LIST:NAME|*
Inserts the name of your list. *|LIST:COMPANY|*
Inserts the name of your company or organization that's listed in the required email footer content for your list *|LIST:SUBSCRIBERS|*
Inserts the number of subscribers in your list in plain-text. *|USER:COMPANY|*
Inserts the company or organization name listed under Primary Account Contact info in your MailChimp account. *|MC:DATE|*
Displays MM/DD/YYYY or DD/MM/YYYY based on your settings in your account Details. *|CURRENT_YEAR|*
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. *|UNSUB|*
Gives your subscribers the opportunity to unsubscribe from your list. (Required by law and our Terms of Use.). *|LIST:DESCRIPTION|*
Inserts your list's permission reminder. *|EMAIL|*
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. Unsubscribe *|EMAIL|* from this list.
*|HTML:LIST_ADDRESS_HTML|*
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. *|LIST:ADDRESS_VCARD|*
Inserts an "Add us to your address book" link to your campaign. *|LIST:ADDRESS_VCARD_HREF|*
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. Or use this to translate the Add us to your address book link. *|LIST:NAME|*
Inserts the name of your list. *|ABOUT_LIST|*
Creates a link to the About Your List page. *|LIST:UID|*
Inserts your list's unique ID from your list's hosted forms. *|PROMO_CODE:[$store_id=x, $rule_id=x, $code_id=x]|*
Use this tag to include a promo code in a campaign. Replace the “x” variables in your Promo Code merge tag to specify what promo code to display. $store_id identifies your connected store, and is set by the API. It defaults to the earliest connected store. You can retrieve store IDs via our API. $rule_id indicates the conditions that must be met in order for a promo code to apply, and is set by the API. For example, a rule that sets a specific discount for a promo code. You can retrieve rule IDs via our API. $code_id identifies your promo code, and is set by the API. You can retrieve code IDs via our API. *|LIST:URL|*
Inserts the website URL set in the Required Email Footer Content for this list. *|LIST:ADDRESS|*
Inserts your company or organization postal mailing address or P.O. Box as plain text. *|LIST:PHONE|*
Inserts your company or organization telephone number. *|LIST:COMPANY|*
Inserts your company or organization name. *|LIST:EMAIL|*
Inserts your default "Reply-To" Email set in the List name & defaults for this list. *|ABUSE_EMAIL|*
Inserts the email address located in the Required Email Footer Content for this list. *|LIST:SUBSCRIBE|*
Inserts the URL for your list's hosted signup form. *|UPDATE_PROFILE|*
Inserts a link to the subscriber's update profile page. *|FORWARD|*
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 signup process. *|OPTIN_DATE|*
Displays the date your subscriber confirmed subscription to your list. Displays MM/DD/YYYY or DD/MM/YYYY based on the settings in your account Details. *|OPTIN_DATETIME|*
Pulls in the date and time your subscriber confirmed subscription to your list. Output is based on the settings in your account Details. *|UNSUB|*
Gives your subscribers the opportunity to unsubscribe from your list. (Required by law and our Terms of Use.) *|UPDATE_PROFILE|*
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. *|USER:COMPANY|*
Displays the company or organization name. *|USER:ADDRESS|*
Inserts the administrator address for the account on a single line. *|HTML:USER_ADDRESS_HTML|*
Inserts the administrator address for the account on multiple lines. *|USER:PHONE|*
Inserts the administrator telephone number for the account. *|USER:URL|*
Inserts the administrator's website URL. *|USER:UID|*
Displays the "u" parameter from your hosted MailChimp list forms.
List information *|LIST:NAME|*
Displays the name of your list. *|LIST:COMPANY|*
Displays the name of your company or organization as set in the Required Email Footer Content for this list. *|LIST:SUBSCRIBERS|*
Displays the number of subscribers in your list in text format. *|LIST:RECENT|*
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. *|LIST:RECENTX|*
Displays clickable links to recent campaigns sent to your list. 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. *|ARCHIVE_LINK_SHORT|*
Creates a shortened URL to your sent campaign. *|LIST:DESCRIPTION|*
Pulls in your list's permission reminder. *|HTML:LIST_ADDRESS_HTML|*
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. *|LIST:ADDRESS_VCARD|*
Adds a standalone "Add us to your address book" link to your campaign. *|LIST:ADDRESS_VCARD_HREF|*
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. *|ABOUT_LIST|*
Creates a link to the About Your List page. *|LIST_HOST|*
Pulls in the "http://yourcompany.us1.list-manage.com/" portion of your hosted form URLs. *|LIST:UID|*
Pulls in the unique ID for your list. *|LIST:URL|*
Pulls in the website URL set under Required Email Footer Content for this list. *|LIST:ADDRESS|*
Inserts your list's mailing address as plain text. *|LIST:PHONE|*
Inserts your company/organization telephone number as set under Required Email Footer Content. *|LIST:EMAIL|*
Inserts your default "Reply-To" Email under List Name and Defaults. *|ABUSE_EMAIL|*
Inserts the email address located under Required Email Footer Content. *|LIST:SUBSCRIBE|*
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. *|LIST:SUBSCRIBERS|*
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."
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. Use Social Share Merge Tags Merge Tags for Facebook Merge Tags for General Sharing Merge Tags for Twitter
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. *|EMAIL_UID|*
Pulls in the "e" parameter from hosted form URLs, campaign tracking links, etc. *|UNIQID|*
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. *|CAMPAIGN_UID|*
Displays the unique ID for your campaign.
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. *|HTML:YOUR_MERGETAG|*
This tag handles list 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. *|URL:YOUR_MERGETAG|*
Encodes the value of your merge tag for inclusion in a URL. For example, if you have a list field with the merge tag, *|QUERY|*, and the 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. *|TITLE:YOUR_MERGETAG|*
Changes the value of your merge tag to be title case (the first letter in each word is capitalized). *|LOWER:YOUR_MERGETAG|*
Changes the value of your merge tag to be all lower case. *|UPPER:YOUR_MERGETAG|*
Changes the value of your merge tag to be all upper case.
Merge tags for Automations Position and Subject Line Merge Tags Use these merge tags to automatically display the numbered position of the email within the automation, and more. They can be used in the subject line or body content for automation 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.) *|AUTOMATION:TOTALEMAILS|*
Displays the total number of emails in the automation. *|AUTOMATION:CURRENTPOSITION|*
Displays the current position of the email within the automation. *|AUTOMATION:NEXTPOSITION|*
Displays the next position in the automation. *|AUTOMATION:PREVIOUSPOSITION|*
Displays the previous position in the automation. *|AUTOMATION:NEXTSUBJECT|*
Displays the subject line of the next email in the automation. *|AUTOMATION:PREVIOUSSUBJECT|*
Displays the subject line of the previous email in the automation.
Leave and Join Automation Merge Tags Use these merge tags to allow subscribers to add or remove themselves from an automation. The Leave Automation merge tag can only be used in its associated automation. *|AUTOMATION:WORKFLOWREMOVEURL|*
Adds a link to your automated email, so subscribers can remove themselves from an automation. This doesn't remove subscribers from the entire list. *|AUTOMATION:WORKFLOWADDURL(campaign_id)|*
Adds a link to your campaign, so subscribers can join an automation they're interested in. Be sure to replace campaign_id with the automation ID.
Merge Tags for Product Recommendations Use the merge tags in this section to add Product Recommendations to a custom-coded campaign. These merge tags pull information directly from your connected store. Product titles, descriptions, images, and prices will be formatted as they are in your store’s database. To automatically add these merge tags in the drag-and-drop editor, use the Product Recommendation content block. *|PRODUCT_RECOMMENDATION:[$store_id=x, $total=x, $start_index=x]|*
This tag is used to open your Product Recommendations block, and allows you to customize what appears.Replace the “x” variables in your opening Product Recommendation merge tag to define the products to display. $store_id identifies your connected store, and is set by the API. It defaults to the earliest connected store. This variable is optional. Only include it if you have multiple stores connected to your list and want to change the default ID. You can retrieve store IDs via our API. $total indicates how many products to display. Replace the “x” with your preferred number. $start_index determines which product to begin with from your list of available recommendations. Replace the “x” with the number of your preferred recommendation. *|PRODUCT:TITLE|*
Inserts the name of a product. *|PRODUCT:URL|*
Inserts the full product page URL as text, and can be used in a hyperlink. *|PRODUCT:CART_URL|*
Inserts the full URL to add a product to a customer’s shopping cart, and can be used in a hyperlink. This tag is available for paid users who have a custom API 3.0 integration, MailChimp for Shopify, MailChimp for Magento, MailChimp for BigCommerce, or MailChimp for WooCommerce. *|PRODUCT:IMAGE_URL|*
Inserts an image URL of a product from the product page.
Note Image URL and Product URL merge tags do not generate a product image or clickable link. They only present the URL text. You can combine these tags to create a clickable image in your campaign. Open the source code and input an "" tag. Place the *|PRODUCT:URL|* merge tag in the “href” value and use the *|PRODUCT:IMAGE_URL|* merge tag in the “src” value.
*|END:PRODUCT_RECOMMENDATION|*
This tag is used to close the customized formatting for your Product Recommendations. *|PRODUCT:PRICE|*
Inserts the price of a product.