Suped

What are the Gmail sender requirements for one-click unsubscribe, and where should the links be placed?

Summary

To comply with Gmail's one-click unsubscribe requirements, senders (especially those sending over 5,000 messages daily) must implement a List-Unsubscribe header containing both 'mailto:' and 'https:' options. This header facilitates a one-click unsubscribe process triggered by mailbox providers. Additionally, a visible and easily accessible unsubscribe link should be included in the email body and/or footer, often directing to a preference center. Unsubscribe requests must be processed promptly, ideally within 24-48 hours, and no later than two days, as required by Gmail and CAN-SPAM. Understanding RFC 8058 and SMTP specifications is crucial for proper implementation. Adherence to these requirements helps maintain sender reputation, avoid spam filters, and improve deliverability.

Key findings

  • List-Unsubscribe Header: Gmail requires a List-Unsubscribe header with both 'mailto:' and 'https:' options for one-click unsubscribe functionality.
  • Visible Unsubscribe Link: A clearly visible and easily accessible unsubscribe link must be included in the email body, often directing to a preference center.
  • Prompt Processing: Unsubscribe requests must be processed promptly, typically within 24-48 hours, but no longer than two days.
  • RFC 8058 Compliance: Adherence to RFC 8058 is necessary for implementing one-click unsubscribe correctly.
  • Bulk Sender Threshold: These requirements are especially critical for senders sending over 5,000 messages daily.

Key considerations

  • Preference Center: Providing a link to a preference center allows subscribers to manage their communication preferences beyond just unsubscribing.
  • Sender Reputation: Properly implementing one-click unsubscribe mechanisms helps improve sender reputation and avoid being marked as spam.
  • CAN-SPAM Alignment: The footer unsubscribe link and preference center align with CAN-SPAM requirements.
  • SMTP Understanding: A good understanding of SMTP is beneficial for ensuring correct implementation of unsubscribe processes.
  • Feedback Loops: Utilizing feedback loops can assist in monitoring unsubscribe rates and identifying potential issues.

What email marketers say

9 marketer opinions

To comply with Gmail's one-click unsubscribe requirements, senders must implement a List-Unsubscribe header containing both 'mailto:' and 'https:' options, process requests promptly, and include a visible unsubscribe link in the email body. Senders should also provide a link to a preference center. Compliance helps maintain sender reputation and avoid deliverability issues.

Key opinions

  • List-Unsubscribe Header: Gmail requires a List-Unsubscribe header with both 'mailto:' and 'https:' options for one-click unsubscribe.
  • Visible Unsubscribe Link: A visible unsubscribe link must be included in the email body.
  • Prompt Processing: Unsubscribe requests must be processed promptly (within 24-48 hours).
  • RFC 8058: RFC 8058 outlines the technical requirements for one-click unsubscribe.

Key considerations

  • Preference Center: Consider providing a link to a preference center in the email body for managing communication preferences.
  • Sender Reputation: Implementing one-click unsubscribe improves sender reputation and helps avoid spam filters.
  • Compliance: Compliance with Gmail's requirements is essential for maintaining deliverability.
  • Bulk Senders: These requirements are mandatory for senders sending more than 5,000 emails a day.

Marketer view

Email marketer from SparkPost explains that Gmail requires a visible unsubscribe link in the body of the email, in addition to the one-click unsubscribe option in the header. This link should take users to a page where they can easily unsubscribe from the mailing list.

28 Nov 2022 - SparkPost

Marketer view

Email marketer from Litmus shares that to comply with Gmail's one-click unsubscribe requirements, email senders need to implement the List-Unsubscribe header with both mailto and HTTPS options, ensuring a seamless unsubscription process for recipients.

1 May 2022 - Litmus

What the experts say

5 expert opinions

Gmail requires a one-click unsubscribe mechanism implemented via the List-Unsubscribe header with both mailto: and https: options. The header facilitates a one-click unsubscribe process triggered by mailbox providers. A visible unsubscribe link directing to a preference center should also be included in the email body/footer, which is required by CAN-SPAM. Unsubscribe requests must be honored promptly.

Key opinions

  • Header Requirement: Gmail requires a List-Unsubscribe header with both mailto: and https: options for one-click unsubscribe.
  • Header Functionality: The List-Unsubscribe header allows mailbox providers to offer a one-click unsubscribe option.
  • Footer Link: A visible unsubscribe link, directing to a preference center, should be included in the email body/footer. This is a requirement of CAN-SPAM.
  • RFC 8058: One-click unsubscribe is related to RFC 8058 support.
  • Processing Time: Unsubscribe requests must be honored promptly.

Key considerations

  • Preference Center: The footer link should go to a preference center where users can easily unsubscribe.
  • Invisible Support: The one-click unsubscribe support in the headers is invisible to the email recipient.
  • CAN-SPAM: The footer link requirement is related to CAN-SPAM compliance.

Expert view

Expert from Email Geeks shares that there should be one link in the body, same as you have now, down in the footer, goes to a subscription center probably. Separately you need (invisible) support in the email headers that’ll be used by mailbox providers and mail clients to implement what they’re calling “one-click unsubscribe”. That’s RFC 8058 support, when you see that term.

28 Aug 2022 - Email Geeks

Expert view

Expert from Email Geeks explains that the one-click functionality being described is really the header-based function, meant to allow the mailbox provider to show an unsub button that links to a backend call that THEY will make when pressed.

24 Apr 2024 - Email Geeks

What the documentation says

4 technical articles

Gmail requires senders sending over 5,000 messages daily to implement one-click unsubscription via a List-Unsubscribe header with both mailto: and https: options. A visible unsubscribe link in the email body is also mandatory. Unsubscribe requests must be processed promptly, within two days. RFC 8058 specifies the technical standard for one-click unsubscribe.

Key findings

  • One-Click Unsubscribe: Senders sending over 5,000 messages daily must enable one-click unsubscription.
  • List-Unsubscribe Header: A List-Unsubscribe header with both mailto: and https: options is required.
  • Visible Link: A clearly visible unsubscribe link must be in the message body.
  • Prompt Processing: Unsubscribe requests must be processed within two days.
  • RFC 8058: RFC 8058 provides the technical standard for one-click unsubscribe.

Key considerations

  • SMTP Knowledge: Understanding SMTP is essential for complying with Gmail's unsubscribe policy.
  • Feedback Loop: Gmail offers a feedback loop to monitor unsubscribe rates.

Technical article

Documentation from Google Developers outlines the importance of processing unsubscribe requests promptly. Google requires senders to process unsubscribe requests within two days and offers a feedback loop to monitor unsubscribe rates.

18 Jun 2022 - Google Developers

Technical article

Documentation from Google Workspace Updates explains that senders who send more than 5,000 messages a day to Gmail accounts will need to enable one-click unsubscription. Gmail requires a clearly visible unsubscribe link in the message body and support for one-click unsubscription. Senders must include a List-Unsubscribe header with both a mailto: and a https: option.

4 Oct 2022 - Google Workspace Updates

Start improving your email deliverability today

Sign up