C
conductor

Fix library / list-unsubscribe-header

HIGHOften searched as: "how to add list-unsubscribe header"

How to add the List-Unsubscribe header (Gmail one-click compliance)

WHAT YOU'RE SEEING

Gmail flags your bulk sends because there's no List-Unsubscribe header, or the existing one isn't one-click compliant.

WHY IT'S HAPPENING

Since Feb 2024, Gmail requires two headers: List-Unsubscribe (with a mailto + HTTPS URL) AND List-Unsubscribe-Post (with the value List-Unsubscribe=One-Click).

How to fix it

  1. 1

    In your email sending platform settings, enable List-Unsubscribe headers.

  2. 2

    Header format: List-Unsubscribe: <mailto:unsub@yourdomain.com>, <https://yourdomain.com/unsubscribe?id=ABC>

  3. 3

    Also include: List-Unsubscribe-Post: List-Unsubscribe=One-Click

  4. 4

    Your URL must accept POST requests and immediately unsubscribe — no confirmation page.

  5. 5

    Test by sending yourself an email — Gmail should show "Unsubscribe" next to the sender name.

Where do I add these records? (by DNS host)

Records go in the DNS panel of whoever hosts your domain, not inside Gmail or Outlook. Find your host below.

Cloudflare

  1. 1.Log in and pick your domain.
  2. 2.Open the DNS tab, then Records.
  3. 3.Click Add record, choose the type (TXT/CNAME), paste the Name and Value, Save.
  4. 4.Tip: Conductor can apply Cloudflare records for you. Connect a token on your domain page instead of doing this by hand.

GoDaddy

  1. 1.Go to My Products, find your domain, click DNS.
  2. 2.Under Records, click Add.
  3. 3.Pick the type, enter the Name (Host) and Value, Save. Use "@" for the root domain.

Crazy Domains

  1. 1.Log in, go to My Account, then Manage next to your domain.
  2. 2.Open DNS / Manage DNS.
  3. 3.Add a record, choose the type, enter the Hostname and Value, Save.

VentraIP

  1. 1.Log in to VIPControl, open Domain Names, click your domain.
  2. 2.Choose Manage DNS / DNS Zone.
  3. 3.Add a record with the type, name and content shown above, Save.

Squarespace / Google Domains

  1. 1.Open Settings, then Domains, and pick your domain.
  2. 2.Choose DNS Settings, scroll to Custom Records.
  3. 3.Add the record type, host and data, Save.

Namecheap

  1. 1.Go to Domain List, click Manage next to your domain.
  2. 2.Open the Advanced DNS tab.
  3. 3.Click Add New Record, set the type, host and value, and save with the green tick.

Not listed? The steps are the same everywhere: find DNS or Manage DNS, add a record, pick the type, paste the name and value shown above.

Not sure if this is your problem?

Paste an email →Check your domain

Related fixes

Gmail's 2024 bulk sender requirements — am I compliant?