Why does list-unsubscribe header not work with a plus sign in Gmail?

Summary

The failure of the list-unsubscribe header to function correctly with plus signs in Gmail stems from inconsistencies in how different email systems and ESPs handle these characters. While Gmail ignores plus signs and any characters following them, many systems don't recognize or properly parse addresses with plus signs. This can be due to ESPs not correctly matching plus-addressed emails, URL encoding issues, or validation tool limitations. The core problem lies in the lack of universal support and standardized interpretation of plus signs in email addresses, as highlighted by both technical documentation and expert opinions. Ultimately, ensuring proper unsubscribe functionality requires careful consideration of ESP configurations, address storage methods, and testing procedures, with a strong emphasis on compliance and user experience. If not managed correctly, there could be legal and financial ramifications.

Key findings

  • Gmail's Plus Sign Handling: Gmail ignores plus signs and characters after them in email addresses.
  • Inconsistent ESP Support: Many ESPs do not fully support or correctly handle plus signs in email addresses, leading to parsing and matching issues.
  • Address Validation Issues: Some email validation tools incorrectly flag addresses with plus signs as invalid.
  • URL Encoding Requirements: Plus signs in URLs within the List-Unsubscribe header may require proper encoding to be correctly interpreted.
  • ESP Configuration Importance: Proper ESP configuration is crucial for handling plus signs and ensuring unsubscribe requests are correctly processed.
  • Compliance Risks: Failure to properly manage unsubscribes can result in legal penalties and reputational damage.

Key considerations

  • ESP Compatibility Testing: Thoroughly test your ESP's handling of plus signs in email addresses and List-Unsubscribe headers.
  • Address Storage Practices: Store complete email addresses, including the plus sign and any subsequent characters, to maintain accurate records.
  • Validation Tool Review: Evaluate and, if necessary, replace email validation tools that do not support plus signs.
  • URL Encoding Enforcement: Ensure that all URLs containing plus signs are correctly encoded within the List-Unsubscribe header.
  • Proactive ESP Communication: Communicate directly with your ESP to address any identified issues or limitations regarding plus sign support.
  • Compliance Awareness: Stay up-to-date on email marketing regulations and best practices regarding unsubscribe functionality.

What email marketers say
8Marketer opinions

The list-unsubscribe header might not work with a plus sign in Gmail due to a variety of reasons related to how email service providers (ESPs) and other systems handle plus addressing. While Gmail recognizes and correctly routes emails with plus signs, some systems may not properly parse, store, or process these addresses. This can lead to unsubscribe requests failing because the system doesn't recognize the plus-addressed email as distinct, or strips off the characters after the plus sign. Furthermore, some email validation tools may not even permit the use of plus signs, impacting subscriptions and opt-ins. The issue could stem from the sender's or recipient's side, with the ESP, server configuration, or email client being the culprit.

Key opinions

  • ESP Incompatibility: Some ESPs do not fully support plus addressing, which means they may not recognize the plus sign or correctly handle the address.
  • Address Parsing Issues: Systems may fail to properly parse the email address with a plus sign, leading to the characters after the plus being stripped or ignored.
  • Validation Limitations: Certain email validation tools do not permit the use of plus signs, potentially blocking sign-ups or subscriptions.
  • Differing Treatment: The unsubscribe feature should treat plus addresses as distinct from non-plus addresses; failure to do so can result in unresolved unsubscribe requests.
  • Source of the Issue: The issue can arise either on the sender's side (ESP configuration) or the recipient's side (client/server settings).

Key considerations

  • ESP Configuration: Ensure your ESP correctly handles plus addresses, recognizing them as unique and processing them accordingly.
  • Address Storage: Do not strip the plus alias when storing email addresses; maintain the full address for accurate identification.
  • Validation Tool Compatibility: If using email validation tools, verify that they support plus addresses to avoid blocking valid sign-ups.
  • Testing Unsubscribe: Test the unsubscribe process with plus addresses to confirm that it effectively removes the user from the mailing list.
  • Contact ESP: If issues persist, contact your ESP for assistance in diagnosing and resolving the problem.
Marketer view

Email marketer from Email Hippo answers that some validation tools do not permit the use of '+', even though it is perfectly valid, which can impact subscriptions, sign-ups, and opt-ins.

March 2022 - Email Hippo
Marketer view

Email marketer from Litmus explains that subaddressing (using the plus sign) helps identify the source of email subscriptions. If a specific subaddress receives spam, you know which service sold your email address, however, some websites might not allow you to sign up using a plus sign.

May 2024 - Litmus
Marketer view

Email marketer from Reddit suggests that the issue can originate either from the sender's or the recipient's side. On the sender's side, the email service provider (ESP) might not recognize the plus sign in the email address or may not be configured to handle it correctly. On the recipient's side, the email client or server might be stripping off the part of the address after the plus sign.

June 2024 - Reddit
Marketer view

Email marketer from Webmaster Forum says that the server side or ESP may be the cause of the issue, meaning they don't see the plus side address as a unique address and could have the software stripping out anything after the plus. Suggests contacting the ESP.

September 2021 - Webmaster Forum
Marketer view

Email marketer from SendGrid answers that subusers are not the same as a + sign, but some of the same things can be achieved using it, such as filtering purposes and monitoring.

July 2021 - SendGrid
Marketer view

Email marketer from Email on Acid shares that plus addressing is useful for filtering and tracking. However, some systems may not recognize or properly handle addresses with plus signs. If unsubscribe isn't working, it's likely the system isn't parsing the address correctly.

March 2025 - Email on Acid
Marketer view

Email marketer from Reddit says that while Gmail supports '+', some email marketing services do not fully support it and it depends on the email service you are using. The issue may be the email service not recognizing the + in the address.

June 2023 - Reddit
Marketer view

Email marketer from Stack Overflow mentions that the best thing to do is not strip the plus alias when storing the email address or when using it to unsubscribe. The unsubscribe feature should treat the plus alias email as different from the non-plus email.

October 2022 - Stack Overflow

What the experts say
5Expert opinions

The issue of the list-unsubscribe header not working with a plus sign in Gmail often stems from the ESP (Email Service Provider) not correctly handling or matching email addresses containing a plus sign. Gmail ignores everything after the '+' sign but ESPs might not 'know' to do the same, leading to a failure to recognize the address for unsubscribing. Moreover, plus signs in URLs might need escaping, and if the ESP generates the List-Unsubscribe header and doesn't accept it with a plus sign, that's the first area to investigate. As a cautionary tale, Gap was fined for improperly managing unsubscribes, underscoring the importance of ensuring the unsubscribe process functions correctly.

Key opinions

  • ESP Matching Issues: ESPs may not correctly match email addresses containing a plus sign.
  • URL Encoding: Plus signs in List-Unsubscribe header URLs may require encoding (%2b).
  • ESP Responsibility: If the ESP generates the List-Unsubscribe header, they are responsible for handling plus signs correctly.
  • Gmail Stripping: Gmail strips information after the plus sign, but ESPs must be aware of this behavior.
  • Real-World Consequences: Failure to properly manage unsubscribes can lead to fines and legal repercussions (e.g., Gap's fine).

Key considerations

  • ESP Testing: Test your ESP's handling of List-Unsubscribe headers with plus signs to ensure they function correctly.
  • Address Matching Logic: Review your ESP's address matching logic to ensure it correctly identifies addresses with plus signs for unsubscribing.
  • URL Encoding Practices: Ensure plus signs in URLs are properly encoded to avoid being misinterpreted.
  • Stay Informed: Stay informed about email deliverability best practices and legal requirements for handling unsubscribes.
  • Ask the ESP: If problems persist, contact your ESP for assistance in troubleshooting and resolving the issue.
Expert view

Expert from Email Geeks shares that Gap was recently fined $200,000 by the CRTC over failing to properly manage unsubscribes. - <https://crtc.gc.ca/eng/archive/2021/ut211206.htm>

February 2024 - Email Geeks
Expert view

Expert from Word to the Wise shares that often the problem lies in an ESP not correctly matching email addresses with a plus sign. They may not know to strip information after the plus sign, like Gmail does.

November 2023 - Word to the Wise
Expert view

Expert from Email Geeks says pluses in URLs may need to be escaped (%2b), or they’ll be treated as whitespace. If the ESP is generating the List-Unsubscribe header, and they’re not accepting it when it’s used with a plus sign, they’re the first place to ask.

December 2021 - Email Geeks
Expert view

Expert from Email Geeks suggests the ESP may not be correctly matching the email address without the +. Depends on if the email address is encoded in the mailto: link or not. Also, they “know” dots in a gmail address should be stripped before they process an unsubscribe, but they don’t “know” things after the + should be as well.

July 2023 - Email Geeks
Expert view

Expert from Spam Resource suggests an ESP may not handle the 'plus' sign, so it's up to the company to ensure that it can handle those addresses. Suggests testing the unsubscribe to make sure it actually removes the user from the list.

July 2024 - Spam Resource

What the documentation says
5Technical articles

The documentation collectively indicates that while Gmail ignores plus signs and characters following them in email addresses, not all mail services or systems adhere to this convention. RFC3464 and IETF documentation acknowledge that the local-part of an email can contain plus signs, but the interpretation is up to the mail server. Therefore, the issue with the list-unsubscribe header not working with a plus sign often arises because other systems or ESPs may not recognize or handle plus signs in the same way as Gmail. Mailchimp highlights the complexity and importance of ESPs properly diagnosing and addressing email issues, while Fastmail notes that full support for plus addressing isn't universal.

Key findings

  • Gmail Ignores Plus Signs: Gmail treats `email@gmail.com`, `e.mail@gmail.com`, and `email+spam@gmail.com` as the same address.
  • RFC & IETF Allowance: RFC3464 and IETF documentation permit plus signs in email addresses, but the interpretation is server-dependent.
  • Lack of Universal Support: Not all mail services fully support plus addressing; some might not recognize or correctly validate such addresses.
  • ESP Complexity: Mailchimp emphasizes the complexity of email addresses and the need for ESPs to diagnose deliverability issues effectively.

Key considerations

  • ESP Compatibility: When dealing with systems beyond Gmail, verify that they correctly handle email addresses with plus signs.
  • Mail Server Interpretation: Recognize that different mail servers might interpret the local-part of email addresses differently, particularly regarding plus signs.
  • Consult with ESP: If encountering deliverability issues, consult with your ESP to diagnose and resolve the problem, especially when custom domains are involved.
  • Address Validation: Ensure address validation processes correctly handle plus signs; incorrect validation could block valid addresses.
Technical article

Documentation from RFC3464 highlights that the local-part of an email address (the part before the @ symbol) is interpreted according to domain naming conventions and may permit other characters. The plus sign is not specifically disallowed but the server on the receiving end has to recognise this convention.

April 2022 - RFC3464
Technical article

Documentation from IETF discusses email address syntax and indicates that the local-part (before the @) can contain various characters, including the plus sign. However, the interpretation of these characters is up to the mail server.

June 2024 - IETF
Technical article

Documentation from Mailchimp explains the complexities with email addresses and custom domains in particular, and the importance of working with your ESP to diagnose the email issue and to ensure a positive user experience for all end-users.

July 2023 - Mailchimp
Technical article

Documentation from Google Support explains that Gmail ignores periods in addresses and plus signs along with any characters after them. This means mail sent to `email@gmail.com` is the same as `e.mail@gmail.com` or `email+spam@gmail.com`.

June 2021 - Google Support
Technical article

Documentation from Fastmail explains that they fully support plus addressing but this is not the case for all mail services, and it might be because the receiving mail service does not support it or their address validation is not correct.

July 2021 - Fastmail