Update: Support for One-Click List-Unsubscribe for Marketo Customers | Community
Skip to main content
Employee
February 2, 2024

Update: Support for One-Click List-Unsubscribe for Marketo Customers

  • February 2, 2024
  • 17 replies
  • 31214 views

As many of you have read or have heard, Gmail and Yahoo has issued a variety of new sender requirements starting on February 1, 2024.  Many of the initial requirements revolve around ensuring messages are properly authenticated with SPF/DKIM/DMARC, as well as compliance with Spam Complaint rates.

 

One of these requirements include the support of One-Click List-Unsubscribe as defined in RFC 8058.  This requirement was pushed out to June 2024 for both Gmail and Yahoo.  What this means is, starting in June 2024, all Bulk senders are required to support One-Click List-Unsubscribe which includes having the presence of the following in their marketing messages:

 

  1. List-Unsubscribe-Post: List-Unsubscribe=One-Click
  2. List-Unsubscribe: <URL Unsubscribe>, [optional <mailto:>]
  3. The URL unsubscribe in the List-Unsubscribe:
    1. Must not direct a customer to a preference page
    2. Support receiving a HTTP POST response back from the receiver
    3. Process the HTTP POST response (unsubscribe the user) within 48 Hrs
  4. Ensuring the List-Unsubscribe-Post and List-Unsubscribe: are included headers in the DKIM Signature (in the h= tag)

 

Marketo has always supported List-Unsubscribe: (RFC 2369) in all Marketing messages by automatically including a <mailto:> option in List-Unsubscribe: Header, and this was a seamless process done automatically without the need of any intervention from our customers.

 

Beginning on January 31, 2024, Marketo has put the necessary changes in place to support the One-Click List-Unsubscribe requirement, and all Marketing messages will support One-Click List-Unsubscribe.  Recipients who request a One-Click Unsubscribe will be automatically unsubscribed from all future communications across a Marketo instance.  We recognize the importance of Operational and Transactional messages, and One-Click List-Unsubscribe or List-Unsubscribe will not be present in these types of messages sent from Marketo.

 

Additional information about these requirements from Google and Yahoo can be found here:

 

 

Thank you very much,

 

Samuel Chang

Product Manager - Deliverability

17 replies

Judah_Altaras
New Participant
March 20, 2025

@samchang wrote:

As many of you have read or have heard, Gmail and Yahoo has issued a variety of new sender requirements starting on February 1, 2024.  Many of the initial requirements revolve around ensuring messages are properly authenticated with SPF/DKIM/DMARC, as well as compliance with Spam Complaint rates.

 

One of these requirements include the support of One-Click List-Unsubscribe as defined in RFC 8058.  This requirement was pushed out to June 2024 for both Gmail and Yahoo.  What this means is, starting in June 2024, all Bulk senders are required to support One-Click List-Unsubscribe which includes having the presence of the following in their marketing messages:

 

  1. List-Unsubscribe-Post: List-Unsubscribe=One-Click
  2. List-Unsubscribe: <URL Unsubscribe>, [optional <mailto:>]
  3. The URL unsubscribe in the List-Unsubscribe:
    1. Must not direct a customer to a preference page
    2. Support receiving a HTTP POST response back from the receiver
    3. Process the HTTP POST response (unsubscribe the user) within 48 Hrs
  4. Ensuring the List-Unsubscribe-Post and List-Unsubscribe: are included headers in the DKIM Signature (in the h= tag)

 

Marketo has always supported List-Unsubscribe: (RFC 2369) in all Marketing messages by automatically including a <mailto:> option in List-Unsubscribe: Header, and this was a seamless process done automatically without the need of any intervention from our customers.

 

Beginning on January 31, 2024, Marketo has put the necessary changes in place to support the One-Click List-Unsubscribe requirement, and all Marketing messages will support One-Click List-Unsubscribe.  Recipients who request a One-Click Unsubscribe will be automatically unsubscribed from all future communications across a Marketo instance.  We recognize the importance of Operational and Transactional messages, and One-Click List-Unsubscribe or List-Unsubscribe will not be present in these types of messages sent from Marketo.

 

Additional information about these requirements from Google and Yahoo can be found here:

 

 

Thank you very much,

 

Samuel Chang

Product Manager - Deliverability


It has been a year, are there any updates here? Is it possible to change this functionality for customers who have developed their own method of handling subscriptions?

New Participant
June 14, 2024

Thanks @sanfordwhiteman ... much appreciate you taking the time to point out the things that are plainly written and I'm not reading. 😕😕

SanfordWhiteman
New Participant
June 13, 2024

@lsubirana you must POST to the URL. Visiting the URL in your browser is a GET. That will not work.

New Participant
June 13, 2024

We are seeing issues with the One-Click unsubscribe where we believe Google & Yahoo are negatively impacting our reputation/spam scores.

Our emails do contain the headers, something that looks similar to this:

List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe: <https://em.vidyo.com/u/Nblahblahblahblahblahblahbla=?emailAddress=blahblahblah>, <mailto:BLAHBLAHBLAH=.1234567@unsub-ab.mktomail.com>
 
Using the mailto link successfully unsubscribes but the URL sends us to a page that contains an error. Is that link going to a page Marketo customers manage? There is an "unresolved" token in the redirect variable in the script.

 


 

SanfordWhiteman
New Participant
May 6, 2024

It is implemented, but bear in mind Google and Yahoo both apply additional heuristics to decide whether to show the in-app unsubscribe link. If they decide some content isn’t “list-y” enough they won’t show the link. This is good for preserving your subscribers but makes troubleshooting more complex!

New Participant
May 6, 2024

Sam - I need to just be crystal clear. Are you are stating that one click unsubscribe is or will be enabled for Gmail/Yahoo - enabling the unsub at the top of the email from Gmail and Yahoo? If so, when will this be implemented? It's not showing up now. 

 

samchangAuthor
Employee
March 13, 2024

Hi Everyone,

 

Thank you very much for your input!    Currently the implementation and unsubscribe behavior of the new URL for the One-Click POST List-Unsubscribe functions exactly as the existing mailto: option, which has been used within Marketo for many years now.   The "unsubscribe" option presented by ISPs such as Gmail/Yahoo/Hotmail has also been in place for senders who meet the ISPs requirements and had always supported either MAILTO or URI, and prior to the recent implementation to support One-Click List-Unsubscribe, all List-Unsubscribe Requests executed via ISPs "unsubscribe" button, would trigger the mailto: unsubscribe, and the lead would be unsubscribed globally across the instance when the mail request is processed on our end.

 

The intention of the roll out was to ensure that we are able to provide the necessary facility for our customers to be in compliance of the upcoming requirements, while not to introducing any new or different behavior to how the current and existing unsubscribe functions when executed via the List-Unsubscribe.

 

I acknowledge everyone's questions and concerns and I will circle back with engineering to see what options are available for customization.    Please stay tuned!

 

Thank you very much,

 

Sam

 

 

JeffHensiek
New Participant
March 13, 2024

I'm in the same boat as @amber_hobson , @tjst3 , and @angelaruggeri .   We have a subscription center where people can choose what content they want to subscribe/unsubscribe.  Are we able to update the unsubscribe section with both options - this way the user could see both the 'global unsubscribe' as well as 'manage subscriptions' options?

Jeff HensiekMarketing Automation Program Manager
Amber_Hobson
New Participant
March 6, 2024

I'm with @angelaruggeri and @tjst3 as well! If this is being implemented by default, how does that work for those of us with custom solutions? We have unsubscribes by brand since we do multiple within our instance. We do have the option to unsubscribe from our entire family but the preference on the one click would be that you are unsubscribing from that brand only by default. Is there any customization with this?

New Participant
March 6, 2024

@angelaruggeri I too struggle with this. While each of our brands manage their own custom unsubscribe/preference fields in Marketo, any one-click unsubscribe solution bypasses those and uses the instance-wide default Unsubscribe in Marketo (which prevents any marketing communications to go out to that contact across any of our brands; regardless of which brands' communication triggered the opt-out).