List-Unsubscribe Header Setup for Cold Email: Complete 2026 Guide
By Puzzle Inbox Team · May 23, 2026 · 6 min read
List-Unsubscribe header is required for bulk senders by Google and Yahoo. Here is how to set it up correctly for cold email.
What List-Unsubscribe Header Does
The List-Unsubscribe email header creates a one-click unsubscribe option that appears in Gmail, Outlook, and other major email clients. Required by Google and Yahoo for bulk senders since February 2024 (RFC 8058).
List-Unsubscribe Header Format
Two-part header in email headers:
List-Unsubscribe: <mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe?id=12345>List-Unsubscribe-Post: List-Unsubscribe=One-Click
The first header provides unsubscribe options. The second header signals one-click compliance.
Why It Matters for Cold Email
Without List-Unsubscribe header, cold email faces:
- Lower inbox placement at Gmail
- Spam folder routing for bulk senders
- Poor reputation signals
- Compliance issues with 2024 bulk sender requirements
Bulk Sender Requirements (Google/Yahoo 2024)
Required for senders above 5,000 emails/day to Gmail or Yahoo:
- List-Unsubscribe header (RFC 8058)
- One-click unsubscribe processing
- Functional unsubscribe within 2 days of click
- Authentication (SPF, DKIM, DMARC)
Even below 5,000/day, having List-Unsubscribe improves deliverability.
How to Set Up List-Unsubscribe
For Cold Email Sending Platforms
Most cold email platforms add List-Unsubscribe automatically:
- Instantly: Adds by default
- Smartlead: Adds by default
- Lemlist: Adds by default
- Apollo: Adds by default
- Saleshandy: Adds by default
Verify by sending test email and checking raw headers.
For Custom SMTP
If sending via custom SMTP, manually add headers:
List-Unsubscribe: <mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>List-Unsubscribe-Post: List-Unsubscribe=One-Click
Configure your unsubscribe handler URL to:
- Accept POST requests at the unsubscribe URL
- Process unsubscribe within 2 days
- Return 200 OK to indicate success
- Add prospect to suppression list
Unsubscribe URL Best Practices
What URL to Use
- Dedicated unsubscribe page on your domain
- Or sending platform-managed unsubscribe URL
What Should Happen When Clicked
- Immediate suppression (no confirmation page)
- Cross-campaign suppression
- Optional confirmation message
Honoring Unsubscribes
CAN-SPAM and GDPR require honoring unsubscribes:
- CAN-SPAM: Within 10 business days
- GDPR: "Without undue delay" — typically immediate
- Bulk Sender requirements: Within 2 days
Best practice: immediate suppression on click.
Cross-Campaign DNC List
Maintain do-not-contact (DNC) list across all campaigns:
- If someone unsubscribes from any campaign, suppress from all
- Even if running multiple ICP campaigns simultaneously
- Document DNC compliance for audits
Verifying List-Unsubscribe Works
Test Procedure
- Send cold email to test address
- Check raw email source (View → Show Raw Source in Gmail)
- Look for List-Unsubscribe header
- Verify unsubscribe URL works
- Click unsubscribe link to confirm processing
Tools to Verify
- Mail-Tester.com — checks header presence
- MXToolbox header analyzer
- Manual raw email inspection
Common List-Unsubscribe Mistakes
- Header missing: Sending platform misconfigured. Contact support.
- Unsubscribe URL broken: Returns 404 or 500. Recipients can't unsubscribe.
- Suppression doesn't work: Recipient gets emails after unsubscribing.
- Confirmation page required: One-click means immediate suppression, no page.
- Different unsubscribe per campaign: Should be unified DNC list.
List-Unsubscribe and Compliance
Beyond technical compliance:
- Functional one-click is now standard
- "Unsubscribe link in footer" alone doesn't meet RFC 8058
- Email body unsubscribe AND header List-Unsubscribe both should work
List-Unsubscribe Per Volume Tier
Under 5,000 emails/day
List-Unsubscribe recommended but not strictly required by Google/Yahoo. Still good practice.
5,000+ emails/day
Required for Gmail/Yahoo deliverability. Without it, deliverability tanks.
10,000+ emails/day
Plus: spam complaint rate must stay under 0.3%. Spam complaints feed back through the unsubscribe system.