Skip to content

Deliverability

Gmail and Yahoo sender requirements

What Gmail and Yahoo require from bulk senders since 2024, what Notifuse handles for you and what you still have to do.

Since February 2024, Gmail and Yahoo filter or reject bulk email that doesn’t meet three rules. Notifuse covers the one-click unsubscribe part. Authentication and complaint rates are up to you and your email provider.

The 2024 rules

Info

This section is general email knowledge, summarized from the Google sender guidelines and the Yahoo sender best practices. Check those pages for the current details.

The rules apply to bulk senders. Google counts a sender as bulk once it sends close to 5,000 messages a day to Gmail addresses.

  • Authentication. Your domain publishes SPF and DKIM, plus a DMARC record (p=none is enough). The domain in the From address must match the domain that passes SPF or DKIM.
  • One-click unsubscribe. Marketing and subscribed messages carry the one-click unsubscribe headers from RFC 8058, and a visible unsubscribe link in the body. Unsubscribes must take effect within two days.
  • Spam rate under 0.3%. Google measures it in Postmaster Tools and recommends staying under 0.1%.

What Notifuse does

It adds the one-click headers

Every email integration adds both headers: Amazon SES, Mailgun, Postmark, SendGrid, SparkPost, Mailjet and SMTP.

List-Unsubscribe: <https://your-endpoint/unsubscribe-oneclick?email=…&email_hmac=…&lids=…&wid=…&mid=…>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

The link uses the workspace’s custom domain when it has one. It carries a signature of the address, so nobody can unsubscribe someone else by editing it.

Only on emails sent for a list

The headers name the list the contact leaves, so Notifuse adds them only to emails sent for a list:

EmailCarries the headers
Broadcast with Exclude unsubscribed recipients on (the default)Yes
Broadcast with Exclude unsubscribed recipients offNo
Automation email (an email step needs the automation’s list)Yes
Test email sent with a Mailing list chosenYes
Transactional email sent through the APINo

Switching Exclude unsubscribed recipients off is meant for notices every member must receive, such as security or legal notices. Mail clients then show no Unsubscribe button on that broadcast. See Notices for every member.

Transactional emails, such as password resets and receipts, are not sent for a list and carry no list links.

How the unsubscribe endpoint answers

When the contact clicks the mail client’s Unsubscribe button, the mail client sends a POST to the link with List-Unsubscribe=One-Click in the body. Notifuse checks the signature and unsubscribes the contact from the list right away. A POST without that token gets a 400 error and unsubscribes nobody.

A GET on the same link never unsubscribes anyone. Anti-spam filters open these links on their own, and mail clients that don’t offer one-click open them in a browser. Notifuse redirects those visits to the notification center, which shows the list and asks the contact to confirm.

The contact’s status on the list becomes unsubscribed. An unsubscribe never replaces a bounced or complained status.

Mail clients only offer one-click when the DKIM signature covers both headers. Your email provider applies that signature, so authenticating your domain with it is what makes the button appear.

What you still have to do

  • Authenticate your domain with SPF, DKIM and DMARC, using the records from your email provider. Notifuse doesn’t check them. See Authenticate your domain.
  • Keep an unsubscribe link in the body. Add {{ unsubscribe_url }} to your marketing templates. See Unsubscribe link.
  • Watch complaints. In Logs, the Messages tab counts Complaints, and the Incoming webhooks tab filters provider events by Type. To be notified, subscribe a webhook to email.complained or list.complained.
  • Watch your Gmail spam rate in Postmaster Tools. Notifuse doesn’t compute a spam rate or read Postmaster Tools. Its complaint count covers what your provider reports, which may not include every complaint Gmail records.
The Messages tab of Logs, where complaints show next to deliveries, opens and bounces
The Messages tab of Logs, where complaints show next to deliveries, opens and bounces

Notifuse stops sending broadcasts and marketing automation emails to contacts who complained. See Bounces and complaints.

Next steps