> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

> [!NOTE]
>
> This section is general email knowledge, summarized from the [Google sender guidelines](https://support.google.com/a/answer/81126) and the [Yahoo sender best practices](https://senders.yahooinc.com/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](https://www.rfc-editor.org/rfc/rfc8058), 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](https://postmaster.google.com) 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.

```text
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](https://www.notifuse.com/docs/features/workspaces.md#custom-endpoint-url) 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:

| Email                                                               | Carries the headers |
| ------------------------------------------------------------------- | ------------------- |
| Broadcast with **Exclude unsubscribed recipients** on (the default) | Yes                 |
| Broadcast with **Exclude unsubscribed recipients** off              | No                  |
| Automation email (an email step needs the automation's list)        | Yes                 |
| Test email sent with a **Mailing list** chosen                      | Yes                 |
| Transactional email sent through the API                            | No                  |

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](https://www.notifuse.com/docs/features/broadcast-campaigns.md#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](https://www.notifuse.com/docs/features/notification-center.md#unsubscribe-from-the-mail-client), 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](https://www.notifuse.com/docs/deliverability/authenticate-your-domain.md).
- **Keep an unsubscribe link in the body.** Add `{{ unsubscribe_url }}` to your marketing templates. See [Unsubscribe link](https://www.notifuse.com/docs/features/templates.md#unsubscribe-link).
- **Watch complaints.** In [Logs](https://www.notifuse.com/docs/features/logs.md), the **Messages** tab counts **Complaints**, and the **Incoming webhooks** tab filters provider events by **Type**. To be notified, subscribe a [webhook](https://www.notifuse.com/docs/features/webhooks.md#email-events) 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](https://www.notifuse.com/docs/assets/screenshots/logs_messages.png)

Notifuse stops sending broadcasts and marketing automation emails to contacts who complained. See [Bounces and complaints](https://www.notifuse.com/docs/deliverability/bounces-and-complaints.md).

## Next steps

- [Authenticate your domain](https://www.notifuse.com/docs/deliverability/authenticate-your-domain.md)
- [Bounces and complaints](https://www.notifuse.com/docs/deliverability/bounces-and-complaints.md)
