Documentation Journey Optimizer Journey Optimizer Guide

Email opt-out management

April 7, 2025

CREATED FOR:

Intermediate
User

When sending messages from journeys or campaigns, you must always ensure that customers can unsubscribe from future communications. Once unsubscribed, the profiles are automatically removed from the audience of future marketing messages. Learn more about privacy & opt-out management

NOTE

All your marketing messages must include an opt-out link. This is not required for transactional messages. The message category - Marketing or Transactional - is defined at the channel configuration level and when creating the message.

To insert an unsubscription link in your email content, you can:

Add a one click unsubscribe URL in the email header. The Enable List-Unsubscribe option at the channel configuration level adds an opt-out link to the email header. Learn more about opt-out in email header
Enable the one-click opt-out link for your email. Learn how to add a one-click opt-out link
Insert a link to a landing page. Learn how to add an opt-out landing page

When a recipient clicks the opt-out link, their unsubscribe request is processed accordingly.

To check that the corresponding profile’s choice has been updated, go to Experience Platform and browse to that profile. In the Attributes tab, you can see the value for choice has changed to no. Learn more in the Experience Platform documentation.

NOTE

Occasionally, unsubscribe events may take longer to reflect at the profile level due to downstream data processing. Allow some time for the system to update.

One-step opt-out

With Adobe Journey Optimizer, you can configure your email configuration settings with an auto-generated one-click unsubscribe URL and mailto address in the email header, or include a one-click opt-out URL in your email body.

One-click unsubscribe URL in the email header

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. Learn how to manage the List unsubscribe option in this section.

One-click opt-out from the email content

To set a personalized unsubscribe URL, insert a one-click opt-out link into the email message content and enter the URL of your choice, as described below:

Access your email content and insert a link.
Select One click Opt-out as the type of link.
Enter the URL of the landing page where the user is redirected once unsubscribed. This page is here to confirm that opting out was successful.

NOTE
If you enabled the List-Unsubscribe option at the channel configuration level and have the default One-click unsubscribe URL option unchecked, this landing page URL is also used when users click the unsubscribe link in the email header. Learn more

You can personalize your links. Learn more about personalized URLs in this section.
Select how you want to apply the opting out: at the channel or identity level.
- Channel: The opt-out applies to future messages sent to the profile’s target (i.e. email address) for the current channel. If several targets are associated with a profile, the opt-out applies to all targets (i.e. email addresses) in the profile for that channel.
- Identity: The opt-out applies to future messages sent to the specific target (i.e. email address) being used for the current message.
Save your changes.

Two-step opt-out

The standard opt-out mechanism relies on two steps: the subscriber clicks the opt-out link in an email, then they are redirected to an opt-out landing page to confirm their unsubscription.

To implement this unsubscription mode, you must create and publish an opt-out landing page, and add an unsubscription link in your email messages, with a link to the landing page. These steps are outlined below.

Prerequisites

To set up a two step opt-out mechanism, you must create your own unsubscription landing pages. The first landing page will be linked from your message and must contain a call-to-action button. A confirmation message should display when the user clicks on the button.

Learn how to create a landing page in Adobe Journey Optimizer to manage unsubscriptions on this page.

You can also use an external landing page. In that case, configure the API to send the information to Adobe Journey Optimizer when a recipients has unsubscribed.

Learn how to implement an opt-out API call

To have your recipients opted out when they submit their choice from the landing page, you must implement a Subscription API call through Adobe Developer to update the corresponding profiles’ preferences.

This POST call is as follows:

Endpoint: https://platform.adobe.io/journey/imp/consent/preferences

Query parameters:

params: contains the encrypted payload
pid: encrypted profile ID

These two parameters will be included into the third-party landing page URL sent to your recipient:

Header requirements:

x-api-key
x-gw-ims-org-id
x-sandbox-name
authorization (user token from your technical account)

Request body:

{
   "marketing": [
       {
            "type": "email",
            "choice": "no",
            "scope": "channel"
        }
    ],

}

Journey Optimizer uses these parameters to update the corresponding profile’s choice through the Adobe Developer API call.

Add an unsubscribe link

You first need to add an unsubscribe link into a message. To do this, follow the steps below:

Create a message and insert a link using the contextual toolbar.
Select the Landing page from the Type drop-down list, and select your opt-out landing page in the Landing page field.

If you are using an external landing page, select External Opt-out/Unsubscription from the Type drop-down list.

In the Link field, paste the link to your third-party landing page.
Click Save.

Send the message with unsubscribe link

Once you configured the unsubscribe link to your landing page, your can create and send your message.

Configure your message with an unsubscription link and send it to your subscribers.
Once the message is received, if the recipient clicks the unsubscribe link, your landing page is displayed.
If the recipient submits the form - here, by hitting the Unsubscribe button in your landing page - the profile data is updated through the API call.
The opted-out recipient is then redirected to a confirmation message screen indicating that opting out was successful.

As a result, this user will not receive communication from your brand unless subscribed again.

recommendation-more-help