Mailchimp is the most widely used SMB email marketing platform, organizing contacts into Audiences (formerly Lists) with automation, tagging, and preference groups. The unsubscribe mechanism uses the *|UNSUB|* merge tag for one-click, or *|UPDATE_PROFILE|* for the full preference center. Mailchimp emits RFC 8058 headers automatically since February 2024 for authenticated domains. This guide covers the merge tags, the Audience-level suppression model, and how to verify the setup end to end.
Mailchimp unsubscribe link
| Tag syntax | *|UNSUB|* |
| Alternative | *|UPDATE_PROFILE|* |
| Placement | Auto-embedded in every campaign footer, enforced at send |
| Scope | Per-Audience with Groups for topic-level opt-out |
| Config path | Audience > Settings > Required Email Footer Content |
| RFC 8058 one-click | Yes, automatic since February 2024 for authenticated domains |
How to add the unsubscribe tag in Mailchimp
Place the merge tag exactly as shown below in the email template. Mailchimp replaces it at send time with a signed URL scoped to the recipient and campaign.
*|UNSUB|*For custom HTML templates, wrap the tag in an anchor to render a proper hyperlink in the delivered email:
<a href="*|UNSUB|*">Unsubscribe from this list</a>Auto-embedded in every campaign footer, enforced at send
Yes, automatic since February 2024 for authenticated domains The recipient's mailbox provider (Gmail, Yahoo) uses the List-Unsubscribe-Post header to expose the native one-click button on the message. Requires domain authentication with DKIM and DMARC.
Mailchimp applies unsubscribes per Audience. A contact who unsubscribes from Audience A remains subscribed to Audience B in the same account. This surprises senders who use multiple Audiences per brand or region and expect an account-wide flag. Mailchimp recommends one primary Audience per business as a best practice to avoid fragmented consent tracking.
Testing your Mailchimp unsubscribe link
- Send a test message to a controlled Gmail address you own via the Mailchimp campaign preview action
- Click the footer unsubscribe link and confirm the opt-out on the landing page
- Check the subscriber or contact record: the status should be Unsubscribed within seconds
- Verify the RFC 8058 headers in Gmail: open the message, click three dots, then Show original. Look for
List-UnsubscribeandList-Unsubscribe-Post: List-Unsubscribe=One-Click
Want the full 222-platform reference?
See the pillar guide with the compliance landscape, the RFC 8058 deep dive, and the unsubscribe tag for every ESP: How to add an unsubscribe link: the complete 2026 guide →
How to add the Mailchimp unsubscribe link (step by step)
Mailchimp campaigns include a default footer with the unsubscribe link and physical address, and Mailchimp blocks the send if either is missing. If you customize the footer or use a fully custom HTML template, follow these steps.
- Open your campaign or template in the Mailchimp editor.
- Edit the footer block, or add a text block where the unsubscribe link should appear.
- Insert the merge tag
*|UNSUB|*for one-click unsubscribe, or*|UPDATE_PROFILE|*for the preference center that lets subscribers update groups and interests. - Wrap it in an anchor with your preferred label:
<a href="*|UNSUB|*">Unsubscribe</a>. - Insert the required
*|LIST:ADDRESSLINE|*merge tag for the physical postal address (Mailchimp pulls it from Audience settings). - Send a test campaign to a seed address. The rendered link should route to the Mailchimp-hosted unsubscribe confirmation page.
Audience-level unsubscribes and groups
Mailchimp unsubscribes apply at the Audience level. A contact who unsubscribes from Audience A remains subscribed to Audience B in the same account, which suits agencies and multi-brand senders. Within a single Audience, Groups let subscribers opt out of specific interest categories through the preference center (via *|UPDATE_PROFILE|*) rather than the entire Audience. Mailchimp enforces one primary Audience per business as a best practice to avoid fragmented consent tracking.
RFC 8058 one-click headers
Mailchimp added RFC 8058 one-click unsubscribe automatically in February 2024, ahead of the Google and Yahoo bulk-sender deadline. The List-Unsubscribe and List-Unsubscribe-Post headers are injected on every marketing send from authenticated domains. Domains that have not completed SPF and DKIM authentication under Domains > Verified Domains fall back to shared Mailchimp infrastructure and may not qualify for the one-click badge in Gmail or Yahoo webmail.
Compliance and physical address requirement
Mailchimp enforces the CAN-SPAM physical address requirement at the platform level: no campaign sends without a valid postal address in the footer. The address is stored per Audience under Audience Settings > Required Email Footer Content and is inserted through the *|LIST:ADDRESSLINE|* merge tag. Mailchimp also enforces the presence of an unsubscribe link in every marketing send, blocking the send at the Send button if either is missing. This is stricter than the CAN-SPAM law itself and provides deliverability protection for the shared IP pools.
Frequently Asked Questions
What is the Mailchimp unsubscribe merge tag?
The tag is *|UNSUB|*. Mailchimp replaces it with a signed URL unique per recipient. Use *|UPDATE_PROFILE|* instead if you want the full preference center where subscribers can update groups and interests rather than fully unsubscribe.
Can I resubscribe someone who unsubscribed from a Mailchimp Audience?
Not through the API. Mailchimp enforces permanent unsubscribe status: an unsubscribed contact cannot be re-added through the API or CSV import. The contact must re-opt in through a hosted signup form on your site, which triggers a fresh confirmation email if double opt-in is enabled on the Audience.
Does Mailchimp support one-click unsubscribe for Gmail and Yahoo?
Yes, automatically since February 2024 for authenticated domains. Mailchimp injects List-Unsubscribe and List-Unsubscribe-Post headers on every marketing send, meeting the Google and Yahoo bulk-sender requirements. Domains need SPF and DKIM verified under Domains > Verified Domains.
Can subscribers opt out of one Group without leaving the Audience?
Yes, through the preference center accessed via *|UPDATE_PROFILE|*. Groups configured as visible on the signup form appear as checkboxes in the preference center, letting subscribers unsubscribe from specific topics while remaining on the Audience for other content.
Can I customize the Mailchimp unsubscribe confirmation page?
Yes, at the Audience level under Signup Forms > Form Builder > Unsubscribe. You can customize the confirmation copy, add branding, and configure the goodbye email. The hosted URL stays on list-manage.com; full custom domain hosting requires third-party workarounds.
About the Author
Alaa · LinkedIn
Email infrastructure specialist with 8+ years of hands-on experience in SMTP, deliverability, and email verification. I’ve configured and troubleshot mail systems across Postfix, Exchange, and cloud relays, managed IP reputation and warmup campaigns, and built verification pipelines processing millions of addresses. My work spans DNS authentication (SPF, DKIM, DMARC, BIMI), bounce handling, blocklist monitoring, and compliance frameworks including CAN-SPAM and GDPR. I write every article on SMTPedia to give email professionals, developers, and marketers the accurate, RFC-grounded reference they need.
About SMTPedia
SMTPedia is an independent email industry reference covering SMTP, IMAP, POP3, email deliverability, marketing platforms, DNS authentication, and email verification. Every article is researched from official provider documentation, IETF RFCs, and industry best practices. Settings and configurations are verified quarterly.
We are cited as a source by ChatGPT, Microsoft Copilot, and thousands of email professionals worldwide. Learn more about our editorial process.
