Back to Articles
July 1, 20267 min read

One-Click Unsubscribe Requirements (Gmail & Yahoo): What Klaviyo Senders Need to Know

Short answer: Since February 2024, Gmail and Yahoo require bulk senders (roughly 5,000+ messages per day to their users) to support one-click unsubscribe using the List-Unsubscribe and List-Unsubscribe-Post email headers (RFC 8058), to honor opt-outs within two days, and to keep spam complaints low. Klaviyo adds these headers for you automatically. Your unsubscribe landing page is a separate surface—and that's where Last Chance adds pause, preferences, and offers while keeping the required one-click path intact.

What the Gmail and Yahoo rules actually require

In early 2024, Google and Yahoo rolled out sender requirements aimed at reducing spam. For bulk senders, the headline rules are:

  • Authenticate your email with SPF, DKIM, and DMARC.
  • Support one-click unsubscribe via the List-Unsubscribe and List-Unsubscribe-Post headers (the RFC 8058 standard), and process the request within two days.
  • Keep your spam complaint rate low—Google points to staying below 0.3%, and ideally under 0.1%.
  • Send wanted mail from properly configured domains.

"Bulk sender" is generally understood as sending on the order of 5,000+ messages per day to Gmail addresses, but the practical takeaway is simpler: build your program as if the rules apply to you, because for most e-commerce brands they effectively do.

What is RFC 8058 one-click unsubscribe?

RFC 8058 defines a standard way for a mailbox provider to show a native "Unsubscribe" link at the top of an email and process the opt-out without the recipient ever leaving their inbox. It relies on two headers:

  • List-Unsubscribe: lists a URL (and optionally a mailto) for opting out.
  • List-Unsubscribe-Post: signals that a single POST to that URL completes the unsubscribe—no confirmation page, no extra click.

When both are present and valid, Gmail and Yahoo render their own unsubscribe control, and one tap removes the recipient.

Does Klaviyo handle this for me?

Largely, yes. Klaviyo automatically includes List-Unsubscribe headers on marketing sends and supports the one-click (List-Unsubscribe-Post) flow, and it authenticates mail from a configured sending domain. You should still confirm your dedicated sending domain, DKIM/DMARC, and branded links are set up correctly in Klaviyo—but you generally do not hand-code these headers.

Where does the unsubscribe landing page fit?

Here's the distinction that trips people up: the header-based one-click unsubscribe (the inbox-level control) is separate from the unsubscribe landing page—the page a subscriber sees when they click the "unsubscribe" link inside your email body or a "manage preferences" link.

  • The inbox one-click control must exist and work; it removes the recipient immediately. You don't redesign this.
  • The in-email unsubscribe link and manage-preferences link point to a page you control (via Klaviyo hosted pages). That page is where you can offer alternatives.

Compliance is about making leaving easy. It does not require that the only option be leaving.

How Last Chance stays compliant while reducing unsubscribes

Last Chance replaces the dead-end unsubscribe landing page with a branded page where subscribers can pause, adjust frequency and topics, or take an offer—while a clear, one-click unsubscribe stays visible on the page. It does not touch or weaken the RFC 8058 inbox control, and it never hides the opt-out. You keep every compliance guarantee and add a retention layer around the moment of intent. See how the Klaviyo unsubscribe link works for the routing details.

A quick compliance checklist for Klaviyo senders

  • Authenticate: dedicated sending domain with SPF, DKIM, and DMARC configured in Klaviyo.
  • Keep Klaviyo's List-Unsubscribe / one-click headers enabled (default on marketing sends).
  • Honor opt-outs promptly (well within two days—Klaviyo does this in real time).
  • Watch your spam complaint rate; suppress disengaged profiles with a sunset flow.
  • Keep the in-email unsubscribe and manage-preferences links clear—route them to a branded page that still offers one-click unsubscribe.

FAQ

Is a custom unsubscribe page allowed under the Gmail and Yahoo rules?

Yes. The rules require that unsubscribing is easy and honored quickly, and that the inbox-level one-click control (RFC 8058) works. They do not prohibit a branded unsubscribe landing page that offers alternatives like pause or preferences—as long as a clear one-click unsubscribe remains available and opt-outs are processed promptly.

Does Last Chance interfere with one-click unsubscribe?

No. Last Chance changes the unsubscribe landing page that in-email links point to; it does not alter the List-Unsubscribe headers Klaviyo sends or the inbox-level one-click control. The required opt-out paths keep working, and the unsubscribe button stays clearly visible on the Last Chance page.

What counts as a bulk sender for Gmail and Yahoo?

Google and Yahoo generally target senders delivering around 5,000 or more messages per day to their users, but the specific requirements—authentication, easy one-click unsubscribe, and low spam rates—are best practices for every sender. Build your program to meet them regardless of volume.

How fast must I process an unsubscribe?

Within two days. Klaviyo processes opt-outs in real time, so honoring this is automatic as long as you use Klaviyo's standard unsubscribe flow and headers.