One-Click List Unsubscribe Header

Prev Next

Effective June 1st, 2024, Gmail and Yahoo require bulk senders to add a one-click list unsubscribe to the email header according to RFC-8058 inside the email header.

  • The one-click list unsubscribe under RFC-8058 must include the HTTPS URL, while the mailto support is optional.
  • Senders need to unsubscribe the user who clicks on the one-click unsubscribe header within 48 hours.
  • The one-click unsubscribe is not required for transactional emails.

Insider includes the one-click list unsubscribe in the email header by default. That is why you do not need to worry about implementing the one-click list unsubscribe functionality. Insider supports the one-click list unsubscribe for its customers in the following three use cases:

#1 - While customers are using Insider’s default unsubscribe links

You can send the promotional email from Insider's panel using the default unsubscribe links (including bulk and Architect emails). The unsubscribe links can be either a global unsubscribe or a preference center.

#2 - While customers are using Insider’s custom unsubscribe links

You can send the promotional email from Insider's panel using the custom unsubscribe links (including bulk and Architect emails).

  • The unsubscribe links can be either a global unsubscribe or a preference center
  • You can see the users who unsubscribe via the one-click list unsubscribe on the User Profile. The Email Unsubscribe event will have the Unsubscribe Type parameter with the list-unsubscribe value. This value indicates that the user clicks the one-click list unsubscribe and unsubscribes. If you export these users, you can unify their unsubscribes on your end. You can export them via the Event Stream.

#3 - While customers are using their own unsubscribe links

You can send promotional emails from Insider’s panel using your own unsubscribe links.

  • You should create a ticket to Insider's Operational Excellence Team to disable the subscription tracking on Sendgrid.
  • You should create a ticket to Insider's Operational Excellence Team to disable the unsubscribe validation.
  • You should not have any Insider's default unsubscribe or custom unsubscribe links inside the email templates.

You should also update Insider for the users who click the unsubscribe link inside the email template and unsubscribe.

If it is sent via the Transactional Email API, the one-click list unsubscribe header is not added to the email.

Your title goes here
Insider currently does not customize the one-click unsubscribe details per customer request.
Your title goes here
The one-click list unsubscribe headers are not included inside the test emails, but only in the campaign launches.
Your title goes here
We recommend you continue using the two-click unsubscribe option in your email template to minimize the impact of email bot clicks.