�۶���Ƶ

List unsubscribe list-unsubscribe

In �۶���Ƶ Journey Optimizer, when configuring a new email channel configuration, upon selecting a subdomain from the list, the Enable List-Unsubscribe option displays. It is enabled by default.

The one-click list unsubscribe URL is an unsubscribe link or button displayed next to the email sender information, and lets recipients instantly opt out of your mailing lists with a single click.

For example, the one-click unsubscribe URL displays a link as below in Gmail:

Depending on the email client, and the email configuration unsubscription settings, clicking the unsubscribe link in the email header can have the following impacts:

In both cases, when a recipient clicks the opt-out link, their unsubscribe request is processed accordingly. The corresponding profile is immediately opted out and this choice is updated in Experience Platform.

Enable List unsubscribe enable-list-unsubscribe

When the Enable List-Unsubscribe option is enabled, if supported by the recipients’ email client, the email header includes both a mailto and/or a URL by default that recipients can use to unsubscribe from your mailing list.

The List unsubscribe header offers two options, which are enabled by default unless you uncheck one or both:

{width="80%"}

You can select the Consent level from the corresponding drop-down list. It can be specific to the channel or to the profile identity. Based on this setting, when a user unsubscribes using the list unsubscribe URL in the header of an email, the consent gets updated in �۶���Ƶ Journey Optimizer, either at the channel level or ID level.

Guardrails and recommendations list-unsubscribe-guardrails

The one-click list unsubscribe URL feature enables your recipients to easily opt out from your communications. However, as not all email clients support this link in the email header, �۶���Ƶ recommends you also add a one-click opt-out link or an unsubscribe link into your email’s body.

The Mailto (unsubscribe) feature and the One-click unsubscribe URL feature are optional.

In Journey Optimizer, consent is handled by the Experience Platform Consent schema. By default, the value for the consent field is empty and treated as consent to receive your communications. You can modify this default value while onboarding to one of the possible values listed here, or use consent policies to override the default logic.

Currently, Journey Optimizer does not append a specific tag to unsubscribe events triggered by the List unsubscribe feature. If you need to differentiate List unsubscribe clicks from other unsubscribe actions, you must implement custom tagging externally, or leverage an external landing page for tracking.

Manage unsubscribe data externally custom-managed

If you are managing consent outside of �۶���Ƶ, select the Customer managed option to enter a custom unsubscribe email address and your own one-click unsubscribe URL.

{width="80%"}

The One-click Unsubscribe URL must be POST URL.

Configure the decrypt API configure-decrypt-api

With the Customer managed option selected, if you enter custom endpoints and use them in a campaign or journey, Journey Optimizer appends some default profile specific parameters to the consent update event when your recipients click the unsubscribe link.

These parameters are sent to the endpoint in an encrypted manner. Thus, the external consent system needs to implement a specific API through to decrypt the parameters sent by �۶���Ƶ.

The GET call to retrieve these parameters depends on the List unsubscribe option you are using - One-click unsubscribe URL or Mailto (unsubscribe).

{
    "profileNameSpace": " CRMID ",
    "profileId": "5142733041546020095851529937068211571",
    "emailAddress": "john@google.com",
    "emailNameSpace": "Email",
    "sandboxId": "sandboxId",
    "optOutLevel": "channel",
    "channelType": "email",
    "timestamp": "2024-11-26T14:25:09.316930Z"
}

{
    "profileNameSpace": " CRMID ",
    "profileId": "5142733041546020095851529937068211571",
    "emailAddress": "john@google.com",
    "emailNameSpace": "Email",
    "sandboxId": "sandboxId",
    "optOutLevel": "channel",
    "channelType": "email",
    "timestamp": "2024-11-26T14:25:09.316930Z"
}