Deliverability
Bulk senders have had a lot of questions around what implementing a one-click unsubscribe process means since the requirement was announced by Gmail and Yahoo in October of 2023. If you already have an unsubscribe link in your email footer is this enough? What exactly is required, and how long to senders have to implement this requirement?
RFC 8058 was first introduced in 2017 as a method to support Signaling One-Click Functionality for List-Unsubscribe Email Header Fields. This means that instead of message recipients scrolling to the footer of an email to follow an unsubscribe link and process manually, they can unsubscribe directly from a mailbox UI, if that mailbox provider supports RFC 8058.
RFC 8058 establishes a standardized way for email senders to indicate that their unsubscribe process is truly one-click. When an email sender implements RFC 8058, they include a specific header field in their emails called a List-Unsubscribe-Post
header This header field contains a URL that, when clicked, triggers the unsubscribe process on the sender’s server.
The email provider (e.g., Gmail, Yahoo) recognizes the “List-Unsubscribe-Post” header and presents the unsubscribe link to the recipient in a clear and prominent way.
Even with the one-click unsubscribe requirement, senders still have the option to return a landing page, but it can’t quite follow the familiar process of a preference page. Senders can return landing pages using a HTTPS URI that contains the necessary information to identify the recipient and list they wish to unsubscribe from, completing the unsubscribe request automatically with no further action required from the user.
Here’s an example of one-click unsubscribe process that returns a landing page:
A user unsubscribes via the one-click unsubscribe option. Then the user is directed to a page like a preference center. Through the redirect, the user is instantly unsubscribed with no further action needed. In this case the preference center serves as a confirmation page with an option to resubscribe if the action was unintended.
In other words, to be valid, one-click unsubscribe under RFC 8058 must include a HTTPS URI in the list unsubscribe header, but mailto is optional. What does this mean?
List-Unsubscribe: <https://example.com/unsubscribe>
List-Unsubscribe: <mailto:unsubscribe@example.com>
If your current list-unsubscribe link requires a secondary action within a preference center, you will need to adjust to remove all secondary click-action processes to be compliant with the requirement per the RFC. A preference center can still be linked elsewhere in the email, or on the unsubscribe confirmation page, to provide further subscription management options.
You may be asking why this requirement is necessary. Some inbox providers are attempting to make the inbox friendly for users. We surveyed consumers in our 2024 report on email and the customer experience and found these top reasons that users unsubscribe.
The top three reasons speak to issues that brands can fix in terms of send volume, relevance, and segmentation. Making it easy to unsubscribe gives inundated subscribers a one click option to leave that spares you from being marked as spam and increasing your spam complaint rate.
Other than how do I implement one-click unsubscribe (which we’ll walk you through next), the other most asked question from senders is how long do I have to implement one-click unsubscribe? June 1, 2024 was the official date for Google and this requirement has been slowly enforced since February 2024.
Senders will have 48 hours to honor unsubscribe requests to meet the requirement. This is true for both Gmail and Yahoo. Once you have implemented RFC 8058, the process is this:
One-click unsubscribe is only required for promotional and commercial messaging, not for transactional messaging. This means that all your triggered password reset emails, shipping confirmations, reminders, etc. are not held to this requirement. We bet you’re thinking, but how do Gmail and Yahoo know which messages are transactional and which are promotional?
“How do Gmail and Yahoo tell the difference between promotional and transactional messages? At a high level it varies based on the industry and the applicable regulations but ultimately, it’s the message recipients that determine the nature of the messages they receive. If you want to reduce high spam rates, give users an easy way to unsubscribe from marketing and promotional messages. Always keep the user in mind when you are deciding on your communications. The user is the one deciding if something is promotional or not.”
Recipient behavior plays a major role in how emails are positioned in the inbox, whether they go to spam and how future emails from a sender are treated. While we may never know the inner workings of mailbox giants like Gmail and Yahoo, there are best practices that are proven to help.
At Sinch Mailgun, we recommend that you separate the reputations between your promotional and transactional messaging by using different subdomains. So transactional messages may come from receipts.domain.com while promotional come from marketing.domain.com.
If you manage your own email program, or even just your unsubscribes, you will have to manually implement a one-click unsubscribe process.
List-Unsubscribe=One-Click
”.List-Unsubscribe-Post
headers.For a full breakdown of the technical and data requirements of RFC 8058, view this tool from ietf.org.
For Sinch Mailgun users, we automatically insert the necessary headers.
Sinch Mailgun offers automated unsubscribe handling in which we insert one-click unsubscribe links into the footer of your emails that automatically process the unsubscribe requests of any recipients who choose to unsubscribe from your mailings.
Two email headers are key to facilitating one-click unsubscribes:
To use Mailgun’s unsubscribe handling, you can enable it in Mailgun’s Control Panel at the Domain-level, which adds the unsubscribe footer to all emails that are sent through that domain. You can also enable with Sinch Mailgun’s APIs at the Email-level, which adds the unsubscribe footer selectively per email that is sent through that domain.
The convenience of one-click unsubscribe mechanisms like RFC 8058 benefits both email recipients and senders by promoting streamlined, user-friendly experiences that enhance email engagement and compliance with unsubscribe requests.
For senders
By offering a true one-click unsubscribe option, senders can improve their sender reputation, reduce spam complaints, and potentially improve deliverability.
“For one-click unsubscribe the RFC you need to follow is RFC 8058. From a benefit perspective, letting people opt out of messages can improve your open rates, click through rates, and your sending efficiency.”
For recipients
Unsubscribing becomes a hassle-free experience, reducing frustration and improving overall email satisfaction while making the unsubscribe process as simple as the process to send an email to spam.
“We want users to unsubscribe to messages they don’t want; we don’t want them to mark them as spam and hurt the reputation of the sender. We have seen by implementing this unsubscribe affordance in the UI that spam marks go down and in some cases are being reduced by 30 to 40%.”
While RFC 8058 is not universally mandatory, it is becoming increasingly adopted by major email providers like Gmail and Yahoo, and marketing automation platforms. Some email clients, like Gmail, even visually distinguish RFC 8058-compliant unsubscribe links for better user awareness.
RFC 8058 represents a significant step forward in simplifying the unsubscribe process for email. As more senders adopt this standard, email communication can become more respectful of recipients’ time and preferences, fostering a more positive overall email experience.
Need help understanding sender requirements? Check out our resource page which provides resources for each of the requirements, and check out our on-demand fireside chat with Gmail and Yahoo to hear the answers straight from these mailbox providers.