# List-Unsubscribe header **URL:** \ **Category:** Product Support\ **Created:** [November 9, 2020, 5:36pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945 "2020-11-09T17:36:59Z")\ **Posts on this page:** 11\ **Page:** 1
**Author:** ![harry5](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/harry5/32/902_2.png) [@harry5](https://forum.mautic.org/u/harry5)\ **Post date:** [November 9, 2020, 5:36pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/1 "2020-11-09T17:36:59Z")
Mautic My Mautic version is: 2.16.2 My PHP version is: 7.3.17-1 My Database type and version is: **Your problem** Can anyone help - I have just been checking with Litmus on inbox deliverability and I’m getting a message saying that there is an issue with some systems (outlook) being the main one. They are saying that have an issue with my List-Unsubscribe header. does anyone have any ideas on how I can fix this? The message I got was: We have detected your message does include a List-Unsubscribe header, however it only provides the URL [https://automate.marketingai.co.uk/email/unsubscribe/5fa976585f3a6301974016](https://automate.marketingai.co.uk/email/unsubscribe/5fa976585f3a6301974016) and does not include the mailto: function. Litmus recommends including a valid and monitored email address option when implementing the List-Unsubscribe header in marketing messaging. ---
**Author:** ![codes9](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/codes9/32/682_2.png) [@codes9](https://forum.mautic.org/u/codes9)\ **Post date:** [November 9, 2020, 6:28pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/2 "2020-11-09T18:28:15Z")
Hi @harry5 Welcome to the Mautic Forums. I think they mean you need an unsubscribe link in your email. You can add {unsubscribe\_url} in your email as a link. ![unsubscribe](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/7/7cc36b0ea830c41ba1f0372baf6ab778f394418f.png) **Some of the Tokens Available in the Email builder:** Unsubscribe Text: {unsubscribe\_text} Unsubscribe URL: {unsubscribe\_url} Web View Text: {webview\_text} Web View URL: {webview\_url} > **[Variables | Mautic Community Documentation](https://docs.mautic.org/en/setup/variables#landing-page-tokens)** ---
**Author:** ![harry5](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/harry5/32/902_2.png) [@harry5](https://forum.mautic.org/u/harry5)\ **Post date:** [November 9, 2020, 6:42pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/3 "2020-11-09T18:42:26Z")
Hi @codes9 thanks for the response, No its the email header where I’m having the issue. I do have the unsubscribe in the body as you say but Litmus is claiming there is an issue in the email header that I should resolve. its driving me slightly crazy ---
**Author:** ![codes9](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/codes9/32/682_2.png) [@codes9](https://forum.mautic.org/u/codes9)\ **Post date:** [November 9, 2020, 7:15pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/4 "2020-11-09T19:15:09Z")
@harry5 You’re right it’s referring to the email header. This can be set by your mail server if you set it up. But you can set this on the email in Mautic: ![headers](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/0/08e5628b8a45eaa7e377dd4dae5d92ff89479afe.png) Your email should include this in the header section. The last part would be the Unsubscribe URL for your mail. ```auto List-Unsubscribe: , ``` ---
**Author:** ![harry5](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/harry5/32/902_2.png) [@harry5](https://forum.mautic.org/u/harry5)\ **Post date:** [November 9, 2020, 7:45pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/5 "2020-11-09T19:45:40Z")
Thanks @codes9 I think I understand now. a couple of questions: 1. instead of adding on each email can I add it to the custom email headers in the config so that it appears on every email automatically? ![Screenshot 2020-11-09 at 19.39.56](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/8/82b03389f2a9454ba59a40e16d1fa2b76fa612e2.png) 2. i get everything apart from the [http://www.example.com/unsubscribe.html](http://www.example.com/unsubscribe.html) bit. how do I create the URL? this is dynamic right? (it will be different for each user) thank you for you help this is really useful ---
**Author:** ![codes9](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/codes9/32/682_2.png) [@codes9](https://forum.mautic.org/u/codes9)\ **Post date:** [November 10, 2020, 1:06pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/6 "2020-11-10T13:06:32Z")
Global custom email headers can also be setup in your config. Click the Gear icon =\> Configuration =\> Mail & Send Settings ![mail-and-send](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/f/f513d33613f64d94e6a34ff58f43aa829e9cbb8a.png) > [@codes9](#): > > You can add {unsubscribe\_url} in your email as a link. The unsubscribe URL would be the same link that is rendered from the short-code inside your email as I referenced above. You’ll have to check what renders in your emails if you put this link. I’ve not tested if this short-code will render in the custom headers section. If you configure custom unsubscribe forms for each email you may need to set-up the header per email. ---
**Author:** ![harry5](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/harry5/32/902_2.png) [@harry5](https://forum.mautic.org/u/harry5)\ **Post date:** [November 10, 2020, 2:52pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/7 "2020-11-10T14:52:16Z")
@codes9 Thank you for your help. I will give it a try ---
**Author:** ![joeyk](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/joeyk/32/11164_2.png) [@joeyk](https://forum.mautic.org/u/joeyk)\ **Post date:** [November 10, 2020, 5:29pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/8 "2020-11-10T17:29:57Z")
Hello @harry5, Thx for bringing up this important topic. The email is added if you have a monitored mailbox. There was a bug related to this, you can see there how this email looks like: > > > What type of report is this: > > Q > A > > > Bug report? > Y > > Feature request? > N > > Enhancement? > N > > Description: > I found multiple value on List-Unsubscribe header in every email sent via Mautic if... If you want to know more about monitored mailbox, you can find it here: > **[Bounce management](https://docs.mautic.org/en/channels/emails/bounce-management)** > > . Monitored Email. Since version 1.2.0 Mautic has provided a feature which allows monitoring of IMAP accounts to detect bounced emails and unsubscribe requests.Note that Mautic makes use of append email addresses. The returnpath or the... Good luck to you! ---
**Author:** ![harry5](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/harry5/32/902_2.png) [@harry5](https://forum.mautic.org/u/harry5)\ **Post date:** [November 10, 2020, 8:40pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/9 "2020-11-10T20:40:33Z")
thanks @joeyk I’m using SES for sending so not using the monitored inbox. I haven’t had a chance to test yet but will feedback as soon as I have. ---
**Author:** ![joeyk](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/joeyk/32/11164_2.png) [@joeyk](https://forum.mautic.org/u/joeyk)\ **Post date:** [November 11, 2020, 5:18am UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/10 "2020-11-11T05:18:31Z")
Hi, I also use Amazon SES. Monitored inbox for your bounces is just an extra setup to generate the mailto unsubscribe and please Litmus. ---
**Author:** ![Francisco](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/francisco/32/556_2.png) [@Francisco](https://forum.mautic.org/u/Francisco)\ **Post date:** [March 11, 2021, 4:16pm UTC](https://forum.mautic.org/t/list-unsubscribe-header/16945/11 "2021-03-11T16:16:55Z")
At the risk of replying to a thread that isn’t active anymore, I tried following the suggestion here to add a List-Unsubscribe header to all emails via Email Sending configuration. However, this doesn’t seem like a valid solution because the headers in these configurations aren’t applied to Mautic emails (see the tooltip): ![image](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/b/b08f7fcf47e7ef6d7be08dcc9958ee280f85306e.png) I don’t want to add the List-unsubscribe header to all emails manually because our emails are created and sent via the REST API. I also saw that the REST API doesn’t provide the capability for adding custom headers to emails created through it. Is there another alternative that I have missed?