Why should I use the List-Unsubscribe header?

It gives inbox providers a safe and standard way to handle unsubscribes, which reduces spam complaints and protects your domain reputation.

Is a mailto link enough for List-Unsubscribe?

A mailto link is better than nothing, but a one click HTTPS link plus mailto fallback gives the best user experience.

Do I still need an unsubscribe link in the body?

Yes. The header complements, not replaces, a visible unsubscribe link in the body of your email.

How to set up List-Unsubscribe on Google Workspace

Step by step List-Unsubscribe setup for Google Workspace: complete instructions, examples, verification commands, and common pitfalls.

Want to check your domain while following this guide?

Run a free SPF, DKIM and DMARC check on your domain to see exactly what is passing and what needs fixing.

No signup required. Works on any domain.

search Run a Free Domain Check notifications_active Monitor my domain

This is a reference guide for configuring List-Unsubscribe on Google Workspace. Use it while editing DNS or when troubleshooting deliverability.

Tip: Configure List-Unsubscribe for Google Workspace in minutes. This guide keeps it practical and safe. Then verify everything with the InboxGreen Free Checker.

Provider-specific notes for Google Workspace

Google Workspace SPF is usually just one include. Problems show up when people add a second SPF TXT record instead of editing the existing one.
DKIM signing must be enabled in the Admin console - publishing the DNS record alone is not enough. Go to Apps → Google Workspace → Gmail → Authenticate email.
Admin console → Apps → Google Workspace → Gmail → Authenticate email (DKIM and SPF).

What is List-Unsubscribe?

List-Unsubscribe is a message header that gives inboxes a safe, machine readable way to unsubscribe. Gmail and Outlook often show a clear unsubscribe link when it is present and valid, which reduces spam complaints and protects your sender reputation.

How to enable it in practice

In your sending platform, enable the List-Unsubscribe header or macro in templates.
Use a one click HTTPS link as the main method, with a mailto address as fallback.
Test by sending to a Gmail address and checking “Show original”.

Example headers

List-Unsubscribe: <https://yourdomain.com/u/abcd1234>, <mailto:[email protected]?subject=unsubscribe>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

Common mistakes

Using a broken or redirected unsubscribe link that fails when clicked.
Only providing a mailto address without a one click URL.
Failing to apply the unsubscribe globally across lists and tools.

Related for Google Workspace

quick_reference_all Set up SPF on Google Workspace quick_reference_all Set up DKIM on Google Workspace quick_reference_all Set up DMARC on Google Workspace

Pro tip: Turn on InboxGreen Monitoring to check these records daily and get alerts if something breaks.

Free Deliverability Scan

Check SPF, DKIM, DMARC and List-Unsubscribe for your domain in seconds.

Useful tools

tune SPF Generator tune DMARC Generator verified Badges