Back to Tools

List-Unsubscribe Header Generator

Generate RFC 8058 compliant List-Unsubscribe and List-Unsubscribe-Post headers. Required by Gmail and Yahoo for bulk senders since 2024. Get ready-to-use headers and code snippets.

List-Unsubscribe Header Generator

Generate RFC 8058 compliant unsubscribe headers for better deliverability

The HTTPS endpoint that handles unsubscribe requests. Required for one-click unsubscribe.

A mailto address as a fallback unsubscribe method

Gmail & Yahoo Requirements (2024+)

  • • Bulk senders (5,000+ emails/day) must support one-click unsubscribe
  • • The HTTPS URL must accept POST requests with the body List-Unsubscribe=One-Click
  • • Unsubscribe must be processed within 2 days
  • • The unsubscribe link must remain valid for the lifetime of the message
  • • Both headers must be present for one-click to work

How one-click unsubscribe works

  1. Email clients detect the List-Unsubscribe and List-Unsubscribe-Post headers
  2. They show an "Unsubscribe" button at the top of the email
  3. When clicked, the client sends a POST request to your HTTPS URL
  4. Your server processes the request and removes the subscriber
  5. This reduces spam complaints because users have an easy alternative

About this tool

Since February 2024, Gmail and Yahoo require bulk senders (5,000+ emails/day) to support one-click unsubscribe via RFC 8058 headers. This generator creates the correct List-Unsubscribe and List-Unsubscribe-Post headers for your emails. Proper unsubscribe handling reduces spam complaints and improves deliverability. Pair this with CAN-SPAM compliance and proper email authentication for best results.

Frequently Asked Questions