Wat is de List-Unsubscribe header bij nieuwsbrieven en marketing e-mails?
Laatst bijgewerkt:
Wanneer je een nieuwsbrief opent in je mailbox, zie je soms een afmeldknop direct naast het afzenderadres. Die knop werkt dankzij de List-Unsubscribe header. Deze e-mail header vertelt mailproviders hoe ontvangers zich kunnen afmelden van een mailinglijst.
Bij Lettermint voegen we automatisch de juiste List-Unsubscribe headers toe aan al je broadcast e-mails. In dit artikel leggen we uit wat de List-Unsubscribe header is, hoe deze werkt en aan welke eisen je moet voldoen.
Wat is de List-Unsubscribe header
De List-Unsubscribe header is een e-mail header die mailproviders vertelt hoe ontvangers zich kunnen afmelden. Het hoofddoel is niet per se een zichtbare knop, maar het beschermen van zowel ontvangers als verzenders.
Wanneer ontvangers zich niet makkelijk kunnen afmelden, gebruiken ze de spamknop. Elke spamklacht schaadt je verzendreputatie. Een slechte reputatie betekent dat je e-mails in de spamfolder belanden of volledig worden geweigerd. De List-Unsubscribe header biedt een uitweg: ontvangers kunnen zich afmelden zonder je als spam te markeren.
Mailproviders gebruiken deze header op verschillende manieren. Gmail en Yahoo tonen vaak een afmeldknop naast het afzenderadres, maar alleen bij verzenders met een goede reputatie. Andere providers zoals Outlook verwerken de header op de achtergrond zonder zichtbare knop. Het resultaat is hetzelfde: een soepel afmeldproces dat je reputatie beschermt.
Er zijn twee versies van deze header:
- List-Unsubscribe: bevat een URL of e-mailadres voor afmeldingen
- List-Unsubscribe-Post: geeft aan dat one-click afmelden mogelijk is
Beide headers werken samen. De eerste header bestaat al sinds 1998 (RFC 2369). De tweede is in 2017 toegevoegd met RFC 8058 om misbruik te voorkomen.
List-Unsubscribe
De List-Unsubscribe header bestaat al sinds 1998 en staat beschreven in RFC 2369. Deze header bevat een URL en/of mailto-adres waarmee ontvangers zich kunnen afmelden:
List-Unsubscribe: <https://example.com/unsubscribe?id=123>, <mailto:unsubscribe@example.com>
Je hebt drie opties:
- Alleen een URL
- Alleen een mailto-adres
- Beide (aanbevolen)
Niet elke mailprovider ondersteunt beide methodes in hun eigen webmail of app:
| Provider | URL | Mailto |
|---|---|---|
| Gmail | ✓ | ✓ |
| Yahoo | ✓ | ✓ |
| Outlook | ✗ | ✓ |
| Apple Mail | ✓ | ✓ |
| Proton Mail | ✓ | ✓ |
Gebruik je een andere e-mailclient zoals Spark of Thunderbird? Dan bepaalt die client of en hoe de List-Unsubscribe header wordt getoond.
List-Unsubscribe-Post
Sinds 2017 is er een extra header: List-Unsubscribe-Post, beschreven in RFC 8058. Deze header maakt one-click unsubscribe mogelijk direct vanuit de e-mailclient. Wanneer je bijvoorbeeld in Gmail op "Afmelden" klikt, stuurt Gmail een POST-request naar de URL. Zo hoeft de ontvanger geen webpagina te bezoeken of iets te bevestigen. Eén klik en klaar.
De waarde is altijd hetzelfde:
List-Unsubscribe-Post: List-Unsubscribe=One-Click
In de praktijk gebruik je beide headers samen:
List-Unsubscribe: <https://example.com/unsubscribe?id=123>, <mailto:unsubscribe@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

List-Unsubscribe bij Lettermint
De List-Unsubscribe header is alleen van toepassing op onze Broadcast route. Bij Transactional e-mails zoals orderbevestigingen en wachtwoord resets is een afmeldmogelijkheid niet nodig en vaak zelfs ongewenst.
Bij broadcast e-mails (via Lettermint) hoef je de List-Unsubscribe header niet zelf in te stellen. We voegen deze automatisch toe. Dit scheelt je extra werk en zorgt ervoor dat je e-mails altijd voldoen aan de richtlijnen van mailproviders zoals Gmail, Yahoo en Outlook.
Wat doet Lettermint automatisch?
- List-Unsubscribe header: We voegen een URL toe
- List-Unsubscribe-Post header: We ondersteunen one-click unsubscribe volgens RFC 8058
- Afmeldlink in de e-mail: Onderaan elke broadcast e-mail staat een zichtbare afmeldlink
Wanneer een ontvanger zich afmeldt (via de header of de link), verwerken we dit direct. Het e-mailadres komt op je suppressions list te staan. Zo kun je geen nieuwe e-mails meer versturen naar dit adres via de broadcast route.
Afmeldingen synchroniseren met je eigen systeem
Wil je afmeldingen ook verwerken in je eigen database? Dat kan via:
- API: Haal suppressions op via onze API
- Webhooks: Ontvang een melding zodra iemand zich afmeldt
Eigen afmeldsysteem gebruiken?
In uitzonderlijke gevallen kunnen we de automatische afmeldlink uitschakelen. Dit is alleen mogelijk als je een eigen afmeldsysteem hebt dat volledig werkt. Je moet dan zelf zorgen voor een zichtbare afmeldlink in je e-mails én de juiste List-Unsubscribe en List-Unsubscribe-Post headers meesturen. Neem contact op met ons support team.
Conclusie
De List-Unsubscribe header is een belangrijk onderdeel van e-mailmarketing. Het biedt ontvangers een eenvoudige manier om zich uit te schrijven, wat zorgt voor minder spamklachten en een betere afzenderreputatie. Grote mailproviders zoals Gmail en Yahoo verplichten deze header inmiddels voor bulkverzenders.
Bij Lettermint hoef je je hier geen zorgen over te maken. We voegen automatisch de juiste headers toe aan al je Broadcast e-mails en beheren uitschrijvingen voor je. Zo voldoe je altijd aan de richtlijnen.