# One-click unsubscribe: what Gmail and Yahoo require from newsletters Source: https://www.tryletterhead.com/blog/one-click-unsubscribe.html Sample headers, in the format RFC 8058 defines. Gmail and Yahoo have enforced one-click unsubscribe since June 2024. Bulk senders must put it in the message headers, not just as a link in the footer, and stop mailing anyone who unsubscribes within two days. Your newsletter platform usually adds the headers. Your job is to check they're there and that unsubscribes take effect quickly. One-click unsubscribe sits alongside the authentication rules. You can check your SPF, DKIM and DMARC with the free [DMARC checker](../tools/dmarc-checker.html). ## What is one-click unsubscribe It's two email headers, defined in RFC 8058: List-Unsubscribe: , List-Unsubscribe-Post: List-Unsubscribe=One-Click With both in place, Gmail and Yahoo show their own unsubscribe button next to your sender name. One click removes the reader, with no login and no "are you sure?" page. ## Who has to support it Google's sender guidelines apply the rule to bulk senders, meaning anyone who sends more than 5,000 messages a day to personal Gmail accounts. Yahoo's Sender Hub requires it for promotional and marketing mail. A newsletter that readers subscribe to counts. Smaller newsletters aren't required to have it, but there's little reason not to. A reader who can't find the unsubscribe link is more likely to click "report spam" instead. ## What else do the Gmail and Yahoo sender rules require Requirement Gmail (bulk senders) Yahoo SPF and DKIM Required Required. DKIM keys of at least 1024 bits. DMARC Required. p=none is accepted. Strongly urged for every sending domain One-click unsubscribe Required in the headers Required for promotional mail, preferably following RFC 8058 Honor unsubscribes Within two days Within two days Spam complaints Stay below 0.1%, never reach 0.3% No published number. High complaint rates get mail deferred. Sources: Google's Email sender guidelines and Yahoo's Sender Hub FAQ. _Free tool · DMARC checker_ Is your DMARC policy where Gmail and Yahoo need it? Type your sending domain to see your DMARC, SPF and DKIM records in plain English. No signup. [Check your DMARC](../tools/dmarc-checker.html) ## How do you check your newsletter's unsubscribe headers - **Find the headers.** Open a copy of your newsletter in Gmail, choose **Show original**, and search for List-Unsubscribe-Post. - **Check the link.** The List-Unsubscribe address should be a working HTTPS link, ideally alongside a mailto address. - **Test it.** Unsubscribe a test address with Gmail's button, and confirm it gets no more issues after two days. - **Keep the footer link too.** The headers power the inbox button. Readers still look for a link at the bottom. If the headers are missing, ask your newsletter platform how to turn them on. Most add them automatically. For the authentication side of the same rules, see [what is DMARC](../blog/what-is-dmarc.html). If your issues are already landing in spam, see [why your newsletter is going to spam](../blog/why-newsletter-going-to-spam.html). Letterhead checks every issue before you schedule it. [Book a test drive](../lp/test-drive.html) #deliverability #compliance #how-to _Keep reading_ ## More on this topic. [Two SPF records? How to merge them into one A domain can publish only one SPF record. With two, receivers treat SPF as broken. How to spot it, merge them, and stay under the 10-lookup limit. Read the post](../blog/multiple-spf-records.html)[Why Gmail Clips Your Newsletter (and How to Stay Under 102KB) Gmail cuts off emails with more than about 102KB of HTML, hiding your last stories and your unsubscribe link. What makes newsletters heavy and how to slim them down. Read the post](../blog/gmail-clipping-newsletter.html)[Hard Bounce vs. Soft Bounce: What Each One Does to Your List A hard bounce means the address is gone for good; a soft bounce means try again later. What causes each, what to do about them, and how to keep bad addresses off your list. Read the post](../blog/hard-bounce-vs-soft-bounce.html) ## Get the Letterhead newsletter. Original analysis on newsletters, weekly. From the team that runs the operating system. [Subscribe](../blog/) [See past issues](../blog/)