List-unsubscribe header

For promotional mails, the CSA requires an additional unsubscribe option using a "One-Click-Unsubscribe" header.

What is a "List-Unsubscribe" header?

The effect of the List-Unsubscribe header is that a button is displayed in the e-mail client, which recipients can use to easily and quickly unsubscribe from newsletters or promotional e-mails. The button is clearly displayed in the header of the email. The recipients do not have to search for and click on an unsubscribe link in the email text.

What does "One-Click" mean?

"One-Click" means that your recipients can unsubscribe with just one click.

  • To do this, your List-Unsubscribe header must contain a List-Unsubscribe post:

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

  • You will also need to provide parameters that uniquely identify your recipient and make it clear from which emails or email type they are unsubscribing from. Work with placeholders from your event configuration and enter the List-Unsubscribe header in angle brackets.

Where can I store the List-Unsubscribe header in Inxmail Commerce?

You can store the list-unsubscribe header inside the mailing settings, see Store list-unsubscribe header or list-help header (Inxmail Commerce). You will find the specifications and practical examples in RFC8058, which you can use as guidance.

Mail relay: If you use Inxmail Commerce in the background as an email dispatch system (= "mail relay"), you must make the setting outside of Inxmail Commerce in your own system. Contact your IT department if you are not sure where and how to store the List-Help header.

SAP Marketing Cloud: As a user of SAP Marketing Cloud, you need a special setting to use the List-Unsubscribe header via One-Click-Unsubscribe. Get in touch with your Inxmail contact person or to enable one-click unsubscribe.

The list-unsubscribe header is a mandatory field for mailings with promotional content. You cannot change the mailing type to “Mailing with promotional content” inside the mailing settings without adding a list-unsubscribe header.

Further information