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
9Marketer 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.

February 2025 - 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.

August 2022 - Litmus
Marketer view

Email marketer from GMass suggests including a one-click unsubscribe link in both the email header and body and making it easy for recipients to opt-out to maintain a good sender reputation and avoid deliverability issues with Gmail.

December 2023 - GMass
Marketer view

Email marketer from ActiveCampaign recommends that in addition to one-click unsubscribe in the header, senders should provide a link to a preference center in the email body where subscribers can manage their communication preferences, aligning with Gmail's updated requirements.

March 2021 - ActiveCampaign
Marketer view

Email marketer from Reddit shares that Gmail's updated policy for bulk senders now requires the implementation of list-unsubscribe headers, which must include both 'mailto:' and 'https:' options for recipients to easily unsubscribe from promotional emails.

August 2022 - Reddit
Marketer view

Email marketer from SendGrid explains that senders must implement one-click unsubscribe functionality to remain compliant with Gmail's new requirements. This means adding the List-Unsubscribe header and ensuring unsubscribe requests are processed promptly.

December 2022 - SendGrid
Marketer view

Email marketer from Email on Acid advises senders to include a clear and easily accessible unsubscribe link in the email body and implement one-click unsubscribe functionality in the email header to improve sender reputation and avoid spam filters.

June 2023 - Email on Acid
Marketer view

Email marketer from Stackoverflow notes that RFC 8058 specifies the technical requirements for implementing one-click unsubscribe functionality, which is now mandatory for senders sending more than 5,000 emails a day to Gmail accounts, making it easier for users to opt-out and improving sender reputation.

July 2021 - Stackoverflow
Marketer view

Email marketer from Mailjet shares that Gmail requires the List-Unsubscribe header to contain both a 'mailto:' and 'https:' option. The mailto: option allows users to unsubscribe via email, while the https: option allows for one-click unsubscription via a web request. It is important to process these requests within 24 hours

January 2023 - Mailjet

What the experts say
5Expert 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.

May 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.

March 2023 - Email Geeks
Expert view

Expert from Spam Resource explains that Gmail's one-click unsubscribe requirement mandates a List-Unsubscribe header with both mailto: and https: options. The header should be implemented correctly to ensure a seamless unsubscribe experience for recipients, and senders must honor unsubscribe requests within 24 hours.

March 2023 - Spam Resource
Expert view

Expert from Email Geeks responds that the footer link should go to a preference center where there should be an obvious “click this button to unsubscribe” without needing anything else. That’s required by CAN-SPAM, and is what people previously called “one-click unsubscribe”. None of that’s new, and it’s probably what you have now.

October 2021 - Email Geeks
Expert view

Expert from Word to the Wise explains that the List-Unsubscribe header should include both a mailto: and an https: URL. The mailto: should allow for an unsubscribe request to be sent via email, while the https: URL should trigger a one-click unsubscription process without requiring the user to fill out a form. It's a requirement from gmail to allow for easy unsubscription, particularly if sending bulk mail.

February 2024 - Word to the Wise

What the documentation says
4Technical 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.

December 2021 - 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.

July 2021 - Google Workspace Updates
Technical article

Documentation from IETF details the specifications for the Simple Mail Transfer Protocol (SMTP), which is essential for understanding the underlying mechanisms of email delivery and how unsubscribe requests are processed, helping senders comply with Gmail's one-click unsubscribe policy.

May 2022 - RFC 5321
Technical article

Documentation from RFC 8058 details the technical standard for one-click unsubscribe, which Gmail requires senders to implement in the email headers. It defines the 'List-Unsubscribe' header field to enable easy unsubscription.

January 2023 - RFC 8058