List Unsubscribe in Apple's iOS 10

As I mentioned before, Apple has provided support for the "list-unsubscribe" header in the built-in mail client on the latest version of their mobile platform, iOS 10. Now that iOS 10 has been released to the world, I've reviewed how this process works and put together what I think you need to know.


Most ESPs that already support the list-unsubscribe header are going to support this new functionality automatically. If you're already seeing "unsubscribe from this mailing list" in the Gmail user interface when sending to Gmail subscribers, you're probably already set to take advantage of this functionality on Apple mobile devices.

Note that only the "mailto" version of the list-unsubscribe header (as defined in RFC 2369) appears to be supported by the iOS mail client. The "http" version of the list unsubscribe header does not appear to be supported. The mail client seems to ignore the "http" versions of the list unsubscribe header.

Assuming that a message contains the correct "mailto" style of list-unsubscribe header, the mail client user interface will show a dismissible banner above the message headers that says, "This message is from a mailing list."


This is followed by a clickable "Unsubscribe" link. If you click on this "Unsubscribe" link, the mail client tells you: "Mail will send a message from (you) to unsubscribe from this mailing list." You can then either hit the cancel button, or continue by clicking on the "Unsubscribe" button.


If you click "Unsubscribe" to allow the mail client to send the unsubscribe request, it generates an email message, from you, with an empty subject line, to the email address specified in the prior message's list unsubscribe header. The body of that message will contain the following text: "iOS Mail sent this email to unsubscribe from the message "(subject line of original message)".


After you unsubscribe in response to a given message, the iOS mail client will no longer show you the banner and unsubscribe link for that message.

Frequently Asked Questions

Are these spam complaints? No, these are "just unsubscribe requests." Your email service provider (ESP) or mailing list management software should capture them just fine, assuming the list-unsubscribe header they have implemented works.

How will these unsubscribes show up in my email service provider (ESP)'s reporting? There is a 99% chance that these unsubscribes will be reported by your ESP the exact same way that current Gmail "list unsubscribes" are tracked and reported. It probably isn't possible to tell Gmail unsubs from Apple mail user unsubs, unless your system can parse the body copy and look for the string "iOS Mail sent this email" to denote which ones are Apple device users. I wouldn't expect most platforms to be able to do that.

Do these reports affect my sending reputation? Probably not. Nothing seems to suggest that Apple is collating this data in any way that would allow it to be used to measure a sender's reputation. Your email service provider (ESP) may or may not take action based on some elevated level of unsubscribes, but this would not be specifically driven by Apple device users.

I want to support this functionality in my mailing list manager. How do I add it? First, read up on VERP, Variable Envelope Return Path. You may already be using VERP for your bounce processing (Return Path header), wherein you use a unique, encoded per-recipient/per-mailing bounce address. (Do it -- it's a best practice.) Basically, just do the same thing for the list-unsubscribe header:
List-unsubscribe: <mailto:(encoded_string)@server-that-handles-unsubs.example.com>
You want to use something VERP-like so that you can just assume that any mail to that address is an unsubscribe request, and that you can trace it to the correct recipient requiring unsubscribing. This saves you from having to parse the from address, or accidentally removing the wrong address. (If you remove the wrong address, the recipient could still receive additional mail, which will likely make them unhappy, and potentially violate the law.)

I see that iOS Mail sends an email reply requesting that I be unsubscribed. What email address is it sending that email message to? It is sending that email message to a special address, specified in the header of the original email message. That header is called "list-unsubscribe." This header is usually hidden, not displayed by default in most email clients. If you select "view source" or "view original" to show all of the email headers, there you'll see the list-unsubscribe header. In that header, the email address to send the unsubscribe request to can be found after the text "mailto:".

Will there be a copy of this emailed unsubscribe request saved to my "Sent" folder? Yes, iOS Mail saves a copy of this message and puts it in your "Sent" folder so that you can review it later, if you so desire.

No comments:

Post a Comment

Comments policy: Al is always right. Kidding, mostly. Be polite, and you're welcome to join in, even if it's a differing viewpoint.