Is quoted printable text allowed in the List-Unsubscribe header?

Summary

The consensus from experts, marketers, and email documentation is that using quoted-printable encoding in the List-Unsubscribe header is generally discouraged due to potential compatibility issues. While RFC 2369 doesn't explicitly forbid it, RFC 2047 restricts encoded words to specific header fields, excluding List-Unsubscribe. Many email clients and ISPs may not correctly interpret encoded characters, leading to unsubscribe failures and deliverability problems. Keeping headers simple, using plain ASCII characters, or URL-encoding URLs within the header are recommended best practices. Thorough testing across different email clients and ISPs is crucial if quoted-printable encoding is used.

Key findings

  • Compatibility Problems: Inconsistent support for quoted-printable encoding in List-Unsubscribe across different email clients (e.g., Hotmail) and ISPs.
  • Deliverability Risks: Poorly encoded headers increase the risk of emails being filtered as spam or rejected.
  • RFC 2047 Restrictions: RFC 2047 limits the use of encoded words to specific header fields, excluding List-Unsubscribe.
  • Simplicity Best Practice: Maintaining simple, easily parsable headers enhances deliverability.
  • URL Encoding Necessity: Any URLs used within the List-Unsubscribe header must be URL-encoded.
  • Non-Standard Encoding: Avoid using non-standard encoding methods in headers.

Key considerations

  • Comprehensive Testing: Perform extensive testing across diverse email clients and ISPs to identify compatibility issues.
  • ASCII/URL Encoding Alternatives: Prefer plain ASCII or URL-encoded URLs as safer alternatives to quoted-printable encoding.
  • Standards Compliance: Ensure adherence to all relevant email standards (RFCs).
  • ESP Configuration: Understand how your ESP handles header encoding and adjust settings as needed.
  • Broken Links: Check for any broken unsubscribe links related to encoding issues

What email marketers say
11Marketer opinions

While technically feasible, the consensus among email marketers is that using quoted-printable encoding in the List-Unsubscribe header is generally discouraged due to potential compatibility issues across different email clients and ISPs. Plain ASCII characters or URL-encoded URLs are preferred for maximum compatibility and deliverability. Testing across various email clients and ISPs is crucial if quoted-printable encoding is used.

Key opinions

  • Compatibility Issues: Quoted-printable encoding can lead to compatibility issues with certain email clients (e.g., Hotmail) and ISPs, causing unsubscribe links to fail.
  • Deliverability Risks: Improperly encoded headers can negatively impact email deliverability, leading to emails being filtered or rejected.
  • URL Encoding: If the List-Unsubscribe header includes a URL, the URL itself should be properly URL-encoded (percent-encoded) to handle special characters.
  • Simplicity Preferred: Keeping email headers as simple as possible, ideally using plain ASCII characters, improves deliverability.
  • Non-Standard Encoding: Avoid using non-standard encoding methods in headers as it increases the chances of deliverability problems.

Key considerations

  • Testing: Thoroughly test the rendering of emails with quoted-printable encoding in the List-Unsubscribe header across various email clients and ISPs.
  • Alternatives: Consider using plain ASCII characters or URL-encoded URLs in the List-Unsubscribe header as safer alternatives to quoted-printable encoding.
  • Standards Compliance: Ensure compliance with email standards for headers to avoid deliverability issues.
  • Error Handling: Implement robust error handling to catch encoding-related issues and prevent broken unsubscribe links.
  • ESP Defaults: Be aware of ESP's default encoding practices and how they may impact header compatibility.
Marketer view

Email marketer from Litmus Blog emphasizes the importance of testing email header compatibility across various email clients. He adds, that if you must use quoted-printable encoding, double-check how different clients render it.

March 2024 - Litmus Blog
Marketer view

Email marketer from Mailchimp specifies that while encoding the entirety of the List-Unsubscribe is not generally recommended, the associated URL should always be URL-encoded.

September 2023 - Mailchimp
Marketer view

Email marketer from Email Geeks explains that if the ESP or mail stream is encoding headers, Hotmail might not decode it properly, displaying it as is. This can lead to issues where unsubscribe links don't appear correctly in some mail apps, causing complaints from senders.

January 2022 - Email Geeks
Marketer view

Email marketer from SendGrid explains that if your List-Unsubscribe header includes a URL, ensure that the URL itself is properly URL-encoded (percent-encoded) to handle special characters. This is different from quoted-printable encoding of the entire header.

February 2024 - SendGrid
Marketer view

Email marketer from Email Geeks shares that the issue of quoted printable text in the List-Unsubscribe header not working is observed frequently in Hotmail mailboxes, while it seems to function correctly elsewhere.

September 2023 - Email Geeks
Marketer view

Email marketer from Campaign Monitor emphasizes that keeping email headers as simple as possible can improve deliverability. Avoid complex encoding unless there is a clear need. In most cases a plain ASCII URL will work fine.

July 2022 - Campaign Monitor
Marketer view

Email marketer from Mailjet Support explains that if you decide to use quoted-printable encoding in email headers like List-Unsubscribe, make sure to test thoroughly with different email clients and ISPs to ensure it is correctly interpreted. Poorly encoded headers can cause deliverability issues.

January 2025 - Mailjet
Marketer view

Email marketer from Email on Acid Blog advises that while technically you *can* encode parts of the List-Unsubscribe header, it's generally better to avoid it because of potential compatibility issues. Stick to URL-encoded ASCII characters if possible.

June 2024 - Email on Acid Blog
Marketer view

Email marketer from Reddit advises to keep List-Unsubscribe simple. If you use a URL, make sure it's properly encoded for the web (percent-encoding), but avoid quoted-printable unless absolutely necessary. Some ISPs and email clients might not handle it correctly, leading to broken unsubscribe links.

July 2022 - Reddit
Marketer view

Email marketer from StackOverflow explains that generally it's safer to avoid encoding the List-Unsubscribe header if possible, and to use plain ASCII characters for maximum compatibility. If encoding is necessary, it's crucial to test thoroughly across different email clients.

December 2022 - StackOverflow
Marketer view

Email marketer from SparkPost emphasizes compliance with email standards for headers. He adds, that avoid using non-standard encoding in headers as it increases the chances of deliverability problems.

September 2024 - SparkPost

What the experts say
3Expert opinions

Experts generally advise against using quoted-printable text in the List-Unsubscribe header. While technically possible, it's considered problematic due to potential compatibility issues with various email clients and ISPs. The consensus is that using quoted-printable can lead to misinterpretation of characters and unsubscribe failures. Sticking to ASCII compatibility is the recommended best practice.

Key opinions

  • Compatibility Issues: Many ISPs and email clients may not correctly interpret quoted-printable encoded characters in the List-Unsubscribe header.
  • Unsubscribe Failures: Using quoted-printable in the List-Unsubscribe header can lead to unsubscribe failures due to misinterpretation by email clients.
  • RFC Limitations: RFC 2047 specifies limited header fields where encoded words are permitted, and List-Unsubscribe isn't one of them.
  • Badly Formed Header: Using quoted-printable outside of the specified fields can result in a badly formed header that may only work accidentally at some ISPs.
  • ASCII Preference: Maintaining ASCII compatibility is the recommended best practice for the List-Unsubscribe header.

Key considerations

  • Alternatives: Consider using alternatives to quoted-printable, such as plain ASCII or URL-encoded characters, in the List-Unsubscribe header.
  • Testing: If quoted-printable is unavoidable, test thoroughly across different email clients and ISPs to ensure correct interpretation.
  • Standards Compliance: Adhere to email standards and RFC specifications to ensure proper formatting and avoid potential issues with deliverability.
Expert view

Expert from Word to the Wise advises against using quoted-printable in the List-Unsubscribe header. While technically possible, it can create compatibility issues across different email clients, and best practice is to maintain ASCII compatibility.

October 2023 - Word to the Wise
Expert view

Expert from Email Geeks explains that quoted printable text is likely not allowed in the List-Unsubscribe header in any useful way, based on RFC 2047 and 2369. He clarifies that RFC 2047 encoded words are only allowed in specific header fields like Subject, Comments, or within a 'phrase' before an email address in the From header. Using it elsewhere results in a badly formed header that may only work accidentally at some ISPs.

February 2023 - Email Geeks
Expert view

Expert from Word to the Wise explains that the usage of quoted-printable in the List-Unsubscribe header is problematic. While technically feasible, many ISPs and email clients may not correctly interpret the encoded characters, leading to unsubscribe failures. It's better to avoid it.

March 2024 - Word to the Wise

What the documentation says
5Technical articles

Email documentation suggests caution when using quoted-printable text in the List-Unsubscribe header. While RFC 2369 doesn't explicitly prohibit it, RFC 2047 restricts encoded words to specific header fields, excluding List-Unsubscribe. General header formatting rules and the importance of valid headers for deliverability are emphasized. Testing compatibility across different email clients is crucial.

Key findings

  • RFC 2047 Restrictions: RFC 2047 limits encoded words to specific header fields, and List-Unsubscribe is not explicitly listed.
  • RFC 2369 Ambiguity: RFC 2369 doesn't explicitly prohibit encoded words in the List-Unsubscribe header, but implementations must ensure validity and parsability.
  • Formatting Rules: Header fields must adhere to specific formatting rules to ensure proper interpretation by mail clients.
  • Deliverability Impact: Improper header encoding can cause filtering or rejection of emails.
  • MIME Encoding Caution: While MIME encoding is supported for email content, its use in headers should be approached with caution.

Key considerations

  • Compatibility Testing: Thoroughly test header encoding across different email clients to ensure compatibility.
  • Validity and Parsability: Ensure that the resulting List-Unsubscribe header remains valid and parsable if using encoded words.
  • Standards Adherence: Adhere to email standards and RFC specifications for header formatting.
  • General Guidance: Apply general header formatting guidelines to the List-Unsubscribe header, even if it's not explicitly addressed in documentation.
Technical article

Documentation from ietf.org explains that RFC 2047 defines how to represent non-ASCII characters in email headers. It specifies that encoded words (using quoted-printable or base64 encoding) are only permitted in specific header fields like Subject, Comments, or certain address fields. The List-Unsubscribe header is not among those explicitly mentioned.

June 2023 - ietf.org
Technical article

Documentation from Microsoft highlights that valid and properly formatted email headers are critical for email deliverability. Improper encoding in headers can cause filtering or rejection. Though it doesn't specifically discuss List-Unsubscribe, this principle applies broadly.

August 2022 - Microsoft
Technical article

Documentation from Mozilla explains that header fields follow specific formatting rules, and while encoding is possible for certain characters, it needs to be done according to standards to ensure proper interpretation by mail clients. It doesn't explicitly address List-Unsubscribe, but the general guidance applies.

January 2025 - Mozilla
Technical article

Documentation from ietf.org explains that RFC 2369 defines the format and usage of the List-Unsubscribe header. The RFC does not explicitly prohibit the use of encoded words within the URI or mailto: address. However, implementations must be cautious about compatibility issues and ensure that the resulting header remains valid and parsable.

June 2023 - ietf.org
Technical article

Documentation from Apache explains that while MIME encoding (including quoted-printable) is supported for email content, its use in headers should be approached with caution. The best practice is to adhere to established standards and test for compatibility across different email clients.

August 2023 - Apache