Here's a quick list of all of the merge tags we have available. You can also dig down into other articles like RSS merge tags or merge tags for campaigns for deeper explanations and examples.
Contents
- Merge Tags for Campaigns
- Merge Tags for Subject Lines
- Merge Tags for Footers
- Social Merge Tags
- Merge Tags for A/B Split Campaigns
- RSS Merge Tags
- Merge Tags for Signup Forms
- Content Encoding
- Conditional Merge Tags
Merge Tags for Campaigns
Every single merge tag on this cheatsheet can be used on your campaigns.
This particular group of tags is available for campaigns only. They cannot be used on signup forms.
Campaigns Only
- *|ARCHIVE|*
- The full Campaign Archive URL.
- *|REWARDS_TEXT|*
- A text-only version of the Rewards link.
- *|MC:TRANSLATE|*
- Links to translate a campaign, HTML is not escaped.
- *|COMMENTS_URL|*
- Facebook Comments URL.
- *|DATE:FORMAT|*
- Shows the current date in the given format "FORMAT". For date formatting, "m" will be replaced by the month, "d" by the day, and "y" by the year. For example, * |DATE:d/m/y| * will show the day, then the month, then the year, separated by slashes. Want to do something more custom with your date? View a full reference of date options on the PHP website (http://us3.php.net/manual/en/function.date.php).
- *|LIST:RECENTX|*
- Recent campaigns for the list where X is the number of posts show and defaults to 5.
- *|TRANSLATE:xx|*
- Link for translating the Archive page in one language. See Example
- *|INTERESTED:|* *|END:INTERESTED|*
- Can be used for sending conditional content to recipients who are in groups on your list.
Merge Tags for Creating Content
- *|MC:TOC|*
- Helps you easily create a table of contents for your newsletter. See Example.
- *|POLL:|* *|END:POLL|*
- Tags allow you to quickly gauge subscriber sentiment about a question or issue, using a rating scale of 1-10. See Example.
- *|QRCOUPON:xxx:yy:zzz|*
- Helps you send unique coupons to each of your recipients. See Example.
- *|LOCAL:EVENTS|*
- Pulls local events from Eventful into your content. See Examples.
- *|LOCAL:DEALS|*
- Pulls local Groupon deals into your content. See Example.
- *|FEED:xxx|*
- Pulls any RSS feed into any campaign. xxx = your feed URL. Multiple instances of this tag can be used within one campaign. See Examples.
- *|EMAIL_UID|*
- The "e" parameter from Hosted Form URLs, campaign tracking links, etc.
- *|UNIQID|*
- $member->email->unique_id; (API function) .
Conditional Merge tags are available to allow you to create dynamic content conditions based on recipient data. See Examples.
Merge Tags for Subject Lines
Data From Your List
The following merge tags will pull information from the lists > settings > required email footer content area of your account.
- *|LIST:NAME|*
- Displays the name of your list.
- *|LIST:COMPANY|*
- Displays the name of your company as defined in the list settings.
- *|LIST:SUBSCRIBERS|*
- Displays only the number of subscribers on your list. You can use this with a text blurb. For example, "*|LIST:SUBSCRIBERS|* Happy Customers are currently enjoying our newsletters."
- *|USER:COMPANY|*
- Displays the company name from the account > contact information area of your account.
- *|MC:DATE|*
- Displays mm/dd/yyyy or dd/mm/yyyy based on your account's time zone and defaults.
- *|CURRENT_YEAR|*
- Will display the current year. This is great 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
- *|UNSUB|*
- Gives your recipients the opportunity leave your list (Required By Law).
- *|LIST:DESCRIPTION|*
- We'll insert the "how did you get my email address!?!?" information that you provided in the list setup wizard. This is always a good tag to use, because people forget signing up for emails all the time. If you don't remind them, they might report you as a spammer to their ISP, who may in turn block all your future emails.
- *|EMAIL|*
- We'll insert each recipient's email address here. So you'll probably see this in the unsubscribe link. This lets people know which email address they'll be removing from your list if they click (comes in handy if the recipient signed up with multiple addresses to your list). You don't need to replace this tag with YOUR email address.
- *|HTML:LIST_ADDRESS_HTML|*
- We'll pull in your mailing address (required by the CAN-SPAM act).
- *|HTML:LIST_ADDRESS_VCARD|*
- We'll add an "Add us to your address book" link that points to the vcard (.vcf) file with your address details.
- *|UPDATE_PROFILE|*
- Gives your recipients the opportunity to change their profile information.
- *|IF:REWARDS|*
- We'll only show the *|REWARDS|* merge tag if you're on a free account or if you have MonkeyRewards turned on for a campaign.
- *|LIST:ADDRESS|*
- We'll insert your company's postal mailing address or PO Box (Required By Law)
- *|LIST:PHONE|*
- We'll insert your company's phone number.
- *|LIST:COMPANY|*
- We'll insert your company's name.
- *|FORWARD|*
- We'll insert the URL to your list's "forward this campaign to a friend" page.
- *|IFNOT:ARCHIVE_PAGE|*
- Hides your CAN-SPAM info, specifically your Permission Reminder and physical address, when someone views the email as an archive page.
Social Merge Tags
Merge tags for Facebook include Like Buttons, sharing campaigns, comments, and pulling profile information into your campaigns.
- *|FACEBOOK:LIKE|*
- Add this merge tag into your campaign, wherever you like, just like regular text, and send your campaign as usual. We'll add the famous "Like" button wherever you place the merge tag.
- *|FACEBOOK:LIKE:URL|*
- Allows your subscribers to like a particular link in your campaign.
- *|FACEBOOK:FULLPROFILE:mailchimp|* or *|FACEBOOK:FULLPROFILE:IDnumber|*
- Place your full Facebook page profile into a campaign, including posts.
- *|FACEBOOK:PROFILE:mailchimp|* or *|FACEBOOK:PROFILE:IDnumber|*
- Place just your Facebook page information into a campaign, without any posts.
- *|FACEBOOK:POSTS3:mailchimp|* or *|FACEBOOK:POSTS3:IDnumber|*
- Replace 3 with any number to set the number of posts that will be shown on your campaign.
- *|FACEBOOK:COMMENTS|*
- Provides a button on your campaign that will link your recipients to Facebook comments. Your subscribers will be able to leave a comment on your campaign and see comments made by other people. This tag is also shown on your campaign archives.
- *|FACEBOOK:COMMENTSURL|*
- Best used inside a link. When you set up your link, set your protocol to "other". When your recipients click on this link, we'll display the comments the same way we do with the comments button above.
- *|FACEBOOK:PROFILEURL|*
- Will display your Facebook URL and username like: http://www.facebook.com/mailchimp.
Merge tags for Twitter include tags for pulling profile information into your campaigns and allowing your recipients to tweet your campaign or a URL in your campaign.
- *|TWITTER:FULLPROFILE|*
- This merge tag will bring in the background from your twitter page, avatar, follower count, a follow button and recent tweets.
- *|TWITTER:PROFILE|*
- This brings in the background, avatar, follower count and a follow button. It will not pull in recent tweets.
- *|TWITTER:TWEETS(NUM)|*
- This lets you control the number of tweets shown in your campaigns. Remove (NUM) and replace it with the number of tweets you want to see on your campaign. For example, if you want 5 recent tweets, use *|TWITTER:TWEETS5|*. You can use this in combination with *|TWITTER:PROFILE|* to really customize what you're sharing with your recipients.
- *|TWITTER:TWEET|*
- Allows your recipients to share your campaign archive link on Twitter. We track these tweets under social stats in the reports tab of your MailChimp account. Copy and paste the *|TWITTER:TWEET|* tag into your campaign, just like you would regular text and we'll display a Tweet button on your newsletter.
- *|TWITTER:PROFILEURL|*
- If you already have your Twitter integration set up, this will display your Twitter URL. For instance http://www.twitter.com/mailchimpux.
Tumblr
Adds a Tumblr Button to your campaign.
- *|TUMBLR:SHARE|*
- Shares a link to your campaign archive using the campaign subject line as the title of the page being shared.
- *|TUMBLR:SHARE[$url=http://yoursitehere.com,$title=My Super Fancy Title]|*
- The optional variable $url specifies the URL shared. If not specified, links to your campaign archive.
The optional variable $title specifies the title of the page being shared. If not specified, uses subject line of your campaign. - *|TUMBLR:SHARE[$url=http://yourwebsiteurlhere.com]|*
- Specifying just the url shares the url you specified with the campaign subject line used as the title of the page being shared.
- *|TUMBLR:SHARE[$title=title of my post]|*
- Specifying just the title shares the url to your campaign archive and the title you've provided.
Google +
Adds a Google +1 button to your campaign.
- *|GOOGLE:PLUSONE|*
- Shares a link to your campaign archive using the campaign subject line as the title of the page being shared.
- *|GOOGLE:PLUSONE[$url=http://yoursitehere.com,$title=My Super Fancy Title]|*
- The optional variable $url specifies the URL shared. If not specified, links to your campaign archive.
The optional variable $title specifies the title of the page being shared. If not specified, uses subject line of your campaign. - *|GOOGLE:PLUSONE[$url=http://yourwebsiteurlhere.com]|*
- Specifying just the url shares the url you specified with the campaign subject line used as the title of the page being shared.
- *|GOOGLE:PLUSONE[$title=title of my post]|*
- Specifying just the title shares the url to your campaign archive and the title you've provided.
Instapaper
Adds a "Read Later" button to your campaigns that directs your subscribers to Instapaper's website to save a URL.
- *|INSTAPAPER:|*
- Shares the direct link to the campaign archive.
- *|INSTAPAPER:[$title=Google, $url=http://google.com, $description=A place where you search for things|*
- The optional variable $url specifies the URL shared. If not specified, links to your campaign archive.
The optional variable $title specifies the title of the page being shared. If not specified, uses the subject line of your campaign.
The optional variable $description specifies the title of the page being shared. If not specified the item is shared without a description. - *|INSTAPAPER:[$url=url to be shared]|*
- Specifying just the url shares the url that you specified, with the campaign subject line as the title of the page being shared but doesn't add a description.
- *|INSTAPAPER:[$title=title to be shared]|*
- Specifying just the title shares a link to your campaign archive and the title you've designated but doesn't add a description.
- *|INSTAPAPER:[$description=description to be shared]|*
- Specifying just the description shares this information along with the link to the campaign archive and uses the subject line of your campaign as the title.
General Sharing
Merge tags will allow your recipients to share your campaigns on sites like del.icio.us and Digg. You can use the default that will display many social sharing sites, or just the ones you choose.
- *|MC:SHARE|*
- See Example.
- *|SHARE:SITE_NAME1,SITE_NAME2|*
- Allows you to select which social sharing sites you share your campaign on.
Videos
Embedded videos aren't supported in most email programs and are often stripped completely. If you have videos you want to share, you can either let us convert your videos automatically, or you can use video merge tags for Blip.tv, YouTube, Vimeo, Vzaar, and Wistia videos.
- *|YOUTUBE:[$vid=XXX]|*
- *|VIMEO:[$vid=XXX]|*
- *|BLIPTV:[$vid=XXX]|*
- *|VZAAR:[$vid=XXX]|*
- *|WISTIA:[$vid=XXX]|*
- XXX is the unique id for the video you're using. You can also control things like whether the title of the video will be displayed, the maximum width of the screenshot and more. See more details and examples.
Merge Tags for A/B Split Campaigns
- *|GROUP:X|* where X = A or B
- Helps you run an A/B split test campaign based on your newsletter content.
RSS Merge Tags
Automagical Formatting
With Automagical formatting, you can quickly pull in your RSS content and go. We do all the formatting for you.
- *|RSS:POSTS_HTML|* and *|RSS:POSTS|*
- The POSTS tags create a progressively generated set of summaries for all of your posts in HTML format. Also shown will be TITLE, DATE, AUTHOR, COMMENTS, Facebook, Google +1 and Twitter sharing buttons. If you want to remove any of these items you can set up items individually.
- *|RSS:POSTS_FULL|* and *|RSS:POSTS_HTML_FULL|*
- The POSTS_FULL tags create a progressively generated set of your full RSS posts in HTML format. Also shown will be TITLE, DATE, AUTHOR, COMMENTS, Facebook, Google +1 and Twitter sharing buttons. If you want to remove any of these items you can set up items individually.
- *|RSS:POSTS_TEXT|*
- Creates a progressively generated set of summaries for all of your posts in text format. Also shown will be TITLE, DATE, AUTHOR, a link to your post, and a link to the comments on the post.
- *|RSS:POSTS_TEXT_FULL|*
- Creates a progressively generated set of all of your posts in text format. Also shown will be TITLE, DATE, AUTHOR, and a link to the comments on the post.
- *|RSS:RECENT|*
- Show links for the 5 most recently published entries before the posts in the email .
Merge Tags for Feeds
If you want more control over what content shows up in your campaign, we let you decide which elements of your RSS feed to show on your campaigns.
- *|RSSFEED:TITLE|*
- The title of the RSS feed.
- *|RSSFEED:DATE|*
- The publish date of the feed.
- *|RSSFEED:URL|*
- The URL for the feed as a whole, if provided.
- *|RSSFEED:DESCRIPTION|*
- The feed description, if provided.
Merge Tags for Items
*|RSSITEMS:|* and *|END:RSSITEMS|*
Create the beginning and ending flags for each RSS item. The stuff between gets replicated for each post in the feed. So if you want to use individual RSS:ITEM merge tags, use *|RSSITEMS:|* and *|END:RSSITEMS|* as your open and close tags surrounding the following items you want to include.
- *|RSSITEM:TITLE|*
- The title of the RSS item.
- *|RSSITEM:URL|*
- The URL for the RSS item.
- *|RSSITEM:DATE|*
- The publish date of the RSS item.
- *|RSSITEM:AUTHOR|*
- The name of the author for the RSS item, if provided.
- *|RSSITEM:COMMENTS_URL|*
- The URL for comments on your post, if provided.
- *|RSSITEM:CATEGORIES|*
- A comma-separated list of the categories (tags and "posted in") for the RSS item.
- *|RSSITEM:CONTENT|*
- A short summary of the RSS item content in HTML format.
- *|RSSITEM:CONTENT_FULL|*
- The full content for the RSS item in HTML format, if provided.
- *|RSSITEM:CONTENT_TEXT|*
- A short summary of the RSS item content in plain-text format.
- *|RSSITEM:CONTENT_FULL_TEXT|*
- The full content for the RSS item in plain-text format, if provided.
- *|RSSITEM:IMAGE|*
- Lets you pull in images and format them to match your layout.
- *|RSSITEM:ENCLOSURE|*
- A link to any attached file (like a podcast) with an icon, file name, and file size.
- *|RSSITEM:ENCLOSURE_URL|*
- The URL for any attached file (like a podcast).
- *|RSSITEM:SOURCE|*
- A link to the external "source" of this item, if one is provided.
This tag will just type out your URL, it will not automatically create a link. If you want the source to be displayed as a link, you'll need to create a link in your campaign. When you set up your link, set your protocol to "other" and place the merge tag in the "URL" field. - *|RSSITEM:SOURCE_TITLE|*
- The title of your source URL.
Social RSS Merge Tags
- *|RSSITEM:SHARE|*
- Add links to popular social bookmarking sites with this RSS item.
- *|RSSITEM:SHARE:Facebook,Twitter,Digg|*
- Add links to specific social bookmarking sites with this RSS item.
- *|RSSITEM:LIKE|*
- Add a Like button for the particular RSS item.
- *|RSSITEM:TWITTER|*
- Add a Tweet button for the particular RSS item.
- *|RSSITEM:TUMBLR|*
- Add a Tumblr button for the particular RSS item.
- *|RSSITEM:PLUSONE|*
- Add a Google +1 button for the particular RSS item.
Merge Tags for Signup Forms
These merge tags can be used on campaigns as well as signup forms.
- *|MC:DATE|*
- Displays mm/dd/yyyy or dd/mm/yyyy in your account's time zone or defaults.
- *|CURRENT_YEAR|*
- Displays the current year.
- *|LIST:RECENTX|*
- Displays recent sent campaigns for the list you're sending to where X = the number of posts you'd like to display. The number of past campaigns defaults to 5. This is great if you want to show examples of recent campaigns to people who are signing up for your list. See Example.
- *|LIST:SUBSCRIBE|*
- Adds your subscription link for the list that you use to send that particular campaign. Learn More.
Merge Tags for Account Information
These merge tags pull from information entered in your account under account > contact information.
- *|USER:UID|*
- The "u" parameter in hosted forms.
- *|USER:COMPANY|*
- The company name given in your account information.
- *|USER:ADDRESS|*
- The address from your account information all on one line.
- *|HTML:USER_ADDRESS_HTML|*
- The address from your account information on multiple lines.
- *|USER:PHONE|*
- The phone number from your account information.
- *|USER:URL|*
- The website listed for your company in your account information.
- *|HTML:REWARDS|*
- The MonkeyRewards badge on your signup forms. If you want to add the MonkeyRewards badge in some place other than the footer, use this tag.
Merge Tags for List Information
These merge tags pull from information entered in your account under list > list settings > required email footer content.
- *|LIST:UID|*
- The "id" parameter for *list* forms. NOT the id for campaign pages/forms.
- *|LIST:NAME|*
- The name of your list.
- *|LIST:COMPANY|*
- The company name from your list settings. For instance, this can be your client's company, instead of the account holder's company.
- *|LIST:ADDRESS|*
- The address from your list settings all on one line.
- *|HTML:LIST_ADDRESS_HTML|*
- The address from your list settings on multiple lines and includes vcard details.
- *|LIST:PHONE|*
- The phone number provided in your list settings.
- *|LIST:URL|*
- The website your provided in the field "Where did people opt-in to this list?" .
- *|LIST:DESCRIPTION|*
- Your Permission Reminder, aka how people came to be on your list.
- *|LIST:EMAIL|*
- The default from email on your signup form.
- *|ABUSE_EMAIL|*
- The contact email address from your signup forms.
Merge Tags for Subscriber Counts
You can use these merge tags to display the number of subscribers to your list.
- *|LIST:SUBSCRIBERS|* Displays a number only. You can use this with a text blurb. For example, "*|LIST_SUBSCRIBERS|* Happy Customers are currently enjoying our newsletters."
- *|LIST:SUBSCRIBER_BADGE|*
- *|LIST:SUBSCRIBER_BADGE1|*
- *|LIST:SUBSCRIBER_BADGE2|*
- *|LIST:SUBSCRIBER_BADGE3|*
- *|LIST:SUBSCRIBER_BADGE4|*
- *|UNSUB|*
- *|UPDATE_PROFILE|*
Content Encoding
The Content Encoding class of merge tags class allows you to modify the way the content inside your various merge tags is displayed. You can make the value displayed appear as all lower case characters using *|LOWER:YOUR_MERGE|* (where *|YOUR_MERGE|* might be something like FNAME for first name or LNAME for last name, etc).
- *|HTML:YOUR_MERGETAG|*
- Encode the variable *|YOUR_MERGETAG|*to support HTML tags inside the field. This tag handles contents as raw HTML and makes no changes.
- *|URL:YOUR_MERGETAG|*
- Encodes the value of *|YOUR_MERGETAG|* for inclusion in a URL (link).
- *|TITLE:YOUR_MERGETAG|*
- Changes the value of *|YOUR_MERGETAG|* to be all title-case (the first letter in each word is capitalized).
- *|LOWER:YOUR_MERGETAG|*
- Changes the value of *|YOUR_MERGETAG|* to be all lower-case.
- *|UPPER:YOUR_MERGETAG|*
- Changes the value of *|YOUR_MERGETAG|* to be all upper-case.
Conditional Content
Conditional or Dynamic Merge tags can also be used on the final welcome email. Smart, Conditional, or Dynamic Merge Tags will allow you to create dynamic content conditions based on recipient data. You can build messages that present content that is unique to each recipient.
Our dynamic merge tags support traditional IF and IF ELSE logic conditions. For example:
*|IF:FOO|* (FOO = merge value you want to test against)
value to display
*|END:IF|*
or
*|IF:FOO|* (FOO = merge value you want to test against)
value to display
*|ELSE:|*
alternative value to display
*|END:IF|*