List-Unsubscribe header

The List-Unsubscribe header is an email header field that provides a method for recipients to easily unsubscribe from email lists. It’s included in the header section of an email and typically contains one or more methods for unsubscribing, such as a URL link or a mailto address. This allows email clients to offer a convenient unsubscribe button or link to the user.

Synerise adds the List-Unsubscribe header to all emails sent through the platform except for the test emails. This solution is supported with all SMTP providers and email senders integrated with Synerise.

Example of the Unsubscribe button next to the sender's name
Example of the Unsubscribe button next to the sender's name

When a recipient clicks the button:

  1. A newsletter.unsubscribe event is generated with the method event parameter set to ONECLICK_LINK or ONECLICK_MAILTO on their profile card in Synerise. The parameter value depends on which method the post client used to unsubscribe the recipient (link or mailto method).
    Example of the newsletter.unsubscribe event with the ONECLICK_LINK method
    Example of the newsletter.unsubscribe event with the ONECLICK_LINK method
  2. A marketingAggreement.turnOff event is generated which results in setting the newsletter agreement attribute to disabled.
    Email agreement attribute set to disabled on the profile card
    Email agreement attribute set to disabled on the profile card
Important: EmailLabs users only: Prior to July 8, 2024, EmailLabs was responsible for adding the List-Unsubscribe header and adding customers to the blacklist. From July 8, 2024, Synerise automatically adds this header and customers are no longer added to the EmailLabs blacklist.

This practice aligns with most mail clients’ requirements, such as Gmail and Yahoo, improving email reputation protection by offering users a direct way to unsubscribe without marking emails as spam.

While the display of the one-click unsubscribe button depends on the mail clients, it is typically reserved for reputable senders. However, the button only appears if the email client’s algorithm allows it. For this reason, we strongly recommend adding the unsubscribe link manually to the email template.

😕

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

😉

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker