List-Unsubscribe Header for Gmail, Hotmail and others

Questions about phpList features (the answer is probably 'Yes!')
Forum rules
Please help the volunteers to help you by supplying the version of phpList you are using, browser & version and if possible, a link to your phpList installation. This is for Version 2 of phpList (the orange one).

List-Unsubscribe Header for Gmail, Hotmail and others

Postby willyhoops » 7:02am, Sun 24 Mar, 2013

There is a thread in this forum about the List-Unsubscribe standard outlined at which requires a header embedded into the email specifying an unsubscribe email address, and which when present gives the user an easy to use unsubscribe button in Gmail and Hotmail and others.

The List-Unsubscribe header is said to be an important feature because if the user clicks spam on the email, Gmail and Hotmail etc will properly unsubscribe rather than silently marking the mail as spam. This helps to preserve the reputation of the sender and reduces traffic and provides feedback on the effect of messages.

The main forum thread about this feature is here:

It dates back to 2009 and talks about a custom mod, but other threads seem to suggest this feature is now built in. I can’t figure out whether this feature exists by default or is a mod, and how to set it up. For example, does the bounce process check for these unsubscribe response email messages manually or do we need to setup a cron job?

Please help, many thanks…
Last edited by willyhoops on 11:23am, Sun 24 Mar, 2013, edited 4 times in total.
phpList newbie
Posts: 4
Joined: 6:15pm, Sat 23 Mar, 2013

Re: List-Unsubscribe Header for Gmail, Hotmail and others

Postby duncanc » 9:01am, Sun 24 Mar, 2013

That processing is not in the stable 2.10.x releases.

The dev version does allow the list-unsubscribe header to be sent. Also I think processing of the unsubscribe responses but not sure how that works.
Posts: 2440
Joined: 6:34am, Sat 08 May, 2010
Location: London

Re: List-Unsubscribe Header for Gmail, Hotmail and others

Postby willyhoops » 9:43am, Sun 24 Mar, 2013

Thank you for replying so promptly, I look forward to seeing this important feature in the next release.

Meanwhile I did some research on the web and found this page:

Shown below are all the code modifications required to include the List-Unsubscribe header in your eMails based on the original phpList forum contributors work (cs & btushar).

These modifications are designed for phplist 2.10.19 which is the current version as of March 2013, and have been tested on my production environment on a hosted server.

What this code lacks is the process that reads the unsubscribed mailbox and processes the messages automatically. Therefore anyone who uses this mod should manually check for unsubscribed messages and manually block any addresses found.

Note: Alan George offers Web Design & Other Services
phpList newbie
Posts: 4
Joined: 6:15pm, Sat 23 Mar, 2013

Re: List-Unsubscribe Header for Gmail, Hotmail and others

Postby AlanGeorge » 12:22pm, Sun 24 Mar, 2013

Many thanks for the plug WillyHoops much appreciated. However the missing code is on the page just not available for download within the 7zip file.
Basically I tried the processunsubscribe.php and unless I missed something it did not work (for me). Looking at the code it appears to be cloned from processbounces.php and requires a Cron user that has been configured to handle bounces, so for me the code has not been completed by the original sources.
My small adjustment to the original hack of placing the Unsubscribe header in the email also re-instates the Precedance Bulk header and adds a Reply-To header which can now be configuered in config.php (email details) and toggled on and off.
The link in WillyHoops will get you to the page....

PL Geek
Posts: 97
Joined: 7:14pm, Tue 28 Feb, 2012

Return to Does phpList do this?

Who is online

Users browsing this forum: No registered users and 1 guest