ClaudeChatGPTCursorGeminiWorks with your AI agentsChromeMydropTry Mydrop Chrome Extension
Publishing Workflows

Mailchimp Merge Tags: The Complete Guide (With Examples)

Every Mailchimp merge tag worth knowing, with copy-paste examples: first names with a fallback, footers, dates, IF/ELSE blocks and how to test them.

5 min read

Hands typing an email on a laptop, the kind of newsletter Mailchimp merge tags personalize

Mailchimp merge tags are placeholders like *|FNAME|* that Mailchimp swaps for each contact's own data when the email goes out. Type Hi *|FNAME|*, and Anna reads "Hi Anna,". Every field in your audience has a tag, and Mailchimp adds system tags for the unsubscribe link, the date, the subject line and your address.

TLDR: Use *|FNAME|* for names, set a default value so empty names don't leave "Hi ,", and test in Preview mode, because conditional tags never fill in test emails.

How Mailchimp merge tags work

Each merge tag sits between *| and |*. When Mailchimp sends, it reads the contact's record and replaces the tag with what it finds.

  • Audience field tags come from your contacts: *|FNAME|*, *|LNAME|*, *|EMAIL|*, plus any field you create.
  • System tags come from Mailchimp: *|UNSUB|*, *|ARCHIVE|*, *|CURRENT_YEAR|* and so on.

To see the tag for each field in your audience, go to Audience, open More options, then Audience fields and merge tags. The tag name is listed next to each field. A custom field like "Plan" gets its own tag, for example *|PLAN|*.

The merge tags you'll actually use

Mailchimp lists over 100 tags. These are the ones that show up in almost every newsletter.

About the contact:

  • *|FNAME|*: first name. Greeting and subject line.
  • *|LNAME|*: last name. Formal greetings.
  • *|EMAIL|*: email address. Footer ("sent to...").

About the email:

  • *|MC:SUBJECT|*: the subject line, often used as the page title in custom code.
  • *|MC_PREVIEW_TEXT|*: preview text in custom-coded emails.
  • *|ARCHIVE|*: a "view in browser" link, usually at the top.
  • *|DATE:d/m/y|*: the send date, in the format you write after the colon.
  • *|CURRENT_YEAR|*: the current year, for the copyright line.

For the footer:

  • *|UNSUB|*: the unsubscribe link (required).
  • *|UPDATE_PROFILE|*: the update preferences link.
  • *|LIST:COMPANY|*: your company name from the audience footer settings. Works in subject lines too.
  • *|HTML:LIST_ADDRESS_HTML|*: your mailing address plus an "add us to your address book" link.
  • *|FORWARD|*: the Forward to a Friend link.
  • *|LIST:SUBSCRIBERS|*: your contact count as text, for a social proof line.

*|UNSUB|* and *|UPDATE_PROFILE|* must be turned into links with the link tool, or they show as plain text.

Copy-paste examples

A greeting:

Hi *|FNAME|*, here's what we shipped this week.

A subject line:

*|FNAME|*, your November picks from *|LIST:COMPANY|*

A footer:

You're getting this because you signed up at *|LIST:COMPANY|*. Sent to *|EMAIL|*. Unsubscribe | Update preferences

(Link "Unsubscribe" to *|UNSUB|* and "Update preferences" to *|UPDATE_PROFILE|*.)

A copyright line:

© *|CURRENT_YEAR|* *|LIST:COMPANY|*

What happens when a contact has no first name

If a contact never filled in their name, Hi *|FNAME|*, becomes "Hi ,". There are two fixes.

Fix 1: a default merge tag value

This works everywhere, subject lines included.

  1. Click Audience and pick the right audience.
  2. Open More options, then Audience fields and merge tags.
  3. Click the three dots next to FNAME, then Edit.
  4. Type your fallback in Default merge tag value, for example "there" or "friend".
  5. Click Save.

The default only shows in sent emails. It is never saved into the contact's record. You can't set one for the Email Address or Address fields.

Fix 2: an IF/ELSE block

This gives you a different sentence, not just a different word:

*|IF:FNAME|*Hi *|FNAME|*,*|ELSE:|*Hi there,*|END:IF|*

Conditional merge tags (IF, ELSE, IFNOT)

Conditional tags show a block only to the contacts who match. Every block ends with *|END:IF|*, in the same content block as the opening tag.

  • *|IF:FIELD|*: shows the content if the field has a value (or matches).
  • *|ELSE:|*: shows the content when the condition is false.
  • *|ELSEIF:FIELD|*: checks another field if the first test failed.
  • *|IFNOT:FIELD|*: shows the content when the field is empty or false.
  • *|END:IF|*: closes the block.

You can compare with =, !=, >, <, >= and <=. An example with a custom "Plan" field:

*|IF:PLAN=Pro|*Your Pro report is attached.*|ELSE:|*Upgrade to Pro to get the full report.*|END:IF|*

Know the limits before you build anything clever:

  • No conditional tags in subject lines. Use a default value there.
  • They don't fill in test emails. Use Preview mode.
  • They read audience fields and groups, not Mailchimp tags.
  • No AND or OR. Nest blocks or create a field that holds the combined value.

Change how a value looks

Wrap any field tag to change its format:

  • *|TITLE:FNAME|* turns "anna" into "Anna"
  • *|UPPER:FNAME|* gives "ANNA", *|LOWER:FNAME|* gives "anna"
  • *|URL:FNAME|* encodes the value for use inside a link
  • *|HTML:FIELD|* outputs the value as raw HTML

*|TITLE:FNAME|* is the quiet fix for lists where people typed their name in lowercase.

How to test merge tags before you send

  1. Open Preview mode and check the email as a real contact, not just as the template.
  2. Check one contact with no first name to see your fallback.
  3. Read the subject line out loud with the tag filled in. "Anna, your November picks" works; a tag mid-sentence often doesn't.
  4. Send a test for layout, but remember conditional blocks stay empty there.

Personal greetings don't help if the email lands in spam. If your open rate dropped, check your sender domain first with our Mailchimp spam fix guide.

Keeping merge tags when you write the email in another tool

Many teams write the newsletter somewhere else and send it with Mailchimp. That is where tags break: in Markdown, the asterisks in *|FNAME|* read as italics, so a tool can strip them and Mailchimp receives |FNAME| as plain text.

Mydrop keeps them. Mydrop is the social media OS for agencies and multi-brand teams, managing 70,000+ posts, and its Mailchimp integration sends your newsletter as a campaign to your own audience:

  • Write the email in the same composer as your social posts. *|FNAME|* and other merge tags stay exactly as you typed them, and Mailchimp fills them in.
  • Schedule it on the content calendar next to the posts it promotes, send it now, or save it as a Mailchimp draft.
  • A warning shows before sending if your sender domain isn't authenticated in Mailchimp.

Your contacts and their fields stay in Mailchimp, so every tag above keeps working. For a weekly format that fits, see how to turn your social posts into a newsletter, and for other tools that connect to Mailchimp, our list of Mailchimp integrations.

Your next step

Open your next newsletter, add *|FNAME|* to the greeting and the subject line, then set a default value on FNAME so nobody gets "Hi ,". Preview it as a contact with no name before you schedule it.

Free tools

Free tools

Calculators, templates and generators for social media teams.

FAQ

Quick answers

A merge tag is a placeholder like *|FNAME|* that Mailchimp replaces with each contact's own data when the email is sent. Every audience field has one, and system tags add things like the unsubscribe link or today's date.

Either set a Default merge tag value on the FNAME field (Audience, More options, Audience fields and merge tags, Edit), or write *|IF:FNAME|*Hi *|FNAME|*,*|ELSE:|*Hi there,*|END:IF|* in the email.

Yes, standard tags like *|FNAME|* and *|LIST:COMPANY|* work in subject lines. Conditional IF/ELSE blocks do not, so set a default value on the field instead.

Mailchimp doesn't fill conditional merge tags in test emails, because they depend on each contact's data. Check them in Preview mode instead.

*|UNSUB|* is the unsubscribe link and *|UPDATE_PROFILE|* is the link to update preferences. Both need to be made clickable with the link tool.

Next step

Stop coordinating around the work

If your team spends more time chasing approvals, assets, and publish details than creating better posts, the problem is probably not your people. It is the workflow around them. Mydrop brings planning, review, scheduling, and performance into one calmer operating system.

Mydrop Editorial Team

About the author

Mydrop Editorial Team

Mydrop

The Mydrop Editorial Team writes the guides, comparisons, and playbooks on this blog. We cover social media planning, publishing, approvals, analytics, and multi-brand workflows, drawing on how teams actually use Mydrop to run their social programs. Every article is researched, edited, and maintained by the team behind the product.

View all articles by Mydrop Editorial Team

Managing 14+ social platforms felt like a 2 a.m. nightmare until Mydrop. The AI brand-voice mapping is scary accurate, and the client approval portal saved me easily 15 hours this week alone. It's the ultimate set-and-forget workspace for busy agencies.
A true automation tool for scheduling (and creating) social media content! It has saved me over 20 hours of work already in just my first couple weeks. A true game-changer for anyone in business, big or small!
Finally tried Mydrop on a test client and the white-label portal on a custom domain actually looks legit, no Mydrop branding sneaking in. The OAuth setup saved me from the usual “what's my password” back-and-forth.
Absolute game-changer. Mydrop completely automated my content workflow. The scheduling is flawless, it actually feels intuitive, and it saved me 10+ hours in my very first week. Best decision I've made for my socials!
Mydrop AI has been an absolute game changer, it has saved me so much time and effort. It does what it promises. Easy to use, versatile, and the creator is really open to feedback. Very happy!
I was looking through a bunch of management tools for my client, as it was getting out of control; after comparing every solution, I found Mydrop to be a no brainer.
This app helps me more than any other I have ever used. I've got all of my pages and accounts and I can drag and drop like I want. Mydrop has really been a huge asset to my business!
I was looking for a scheduling tool as my clients were using more and more platforms. Mydrop does the job very well, and automations and forms are very useful and save me a lot of time. I recommend!
Love that you baked in white-label portals from day one, that's a huge pain point for agencies.
Love this platform for scheduling social media posts! Easy and very intuitive to use! Highly recommend!
Very nice tool, you will save a lot of time. Very easy to use, user friendly. I have used it for several months and it is very helpful.
Helpful app if you are trying to streamline social content creation for clients.
Smiling social media managerSmiling social media managerSmiling social media managerSmiling social media managerSmiling social media managerSmiling social media manager

Excellent · on Trustpilot