¿Qué es el header List-Unsubscribe?
Última actualización:
Cuando abres una newsletter en Gmail, a veces ves un botón de cancelación directamente junto a la dirección del remitente. Ese botón funciona gracias al header List-Unsubscribe. Este header indica a los proveedores de correo cómo los destinatarios pueden cancelar su suscripción a tu lista de correo. Desde junio de 2024, este header es obligatorio para remitentes masivos en Gmail y Yahoo.
En Lettermint, añadimos automáticamente los headers List-Unsubscribe correctos a todos tus Broadcast emails. En este artículo explicamos qué es el header List-Unsubscribe, cómo funciona y por qué ya no puedes ignorarlo.
Qué es el header List-Unsubscribe
El header List-Unsubscribe es un header de correo que indica a los proveedores de correo cómo los destinatarios pueden cancelar su suscripción. El objetivo principal no es necesariamente un botón visible, sino proteger tanto a destinatarios como a remitentes.
Cuando los destinatarios no pueden cancelar fácilmente su suscripción, usan el botón de spam. Cada queja de spam daña tu reputación de remitente. Una mala reputación significa que tus correos terminan en la carpeta de spam o son rechazados por completo. El header List-Unsubscribe ofrece una alternativa: los destinatarios pueden cancelar su suscripción sin marcarte como spam.
Los proveedores de correo utilizan este header de diferentes maneras. Gmail y Yahoo a menudo muestran un botón de cancelación junto a la dirección del remitente, pero solo para remitentes con buena reputación. Otros proveedores como Outlook procesan el header en segundo plano sin botón visible. El resultado es el mismo: un proceso de cancelación fluido que protege tu reputación.
List-Unsubscribe
El header List-Unsubscribe contiene una URL o dirección de correo donde se pueden enviar las solicitudes de cancelación. Este header existe desde 1998 y está descrito en RFC 2369. Los proveedores de correo leen este header para ofrecer una opción de cancelación a los destinatarios.
List-Unsubscribe: <https://example.es/cancelar?id=abc123>, <mailto:cancelar@example.es?subject=unsubscribe>
Hay tres posibilidades:
- URL: redirige a los destinatarios a una página de cancelación
- Mailto: permite a los destinatarios cancelar enviando un correo
- Ambos: máxima compatibilidad con todos los proveedores de correo
No todos los proveedores de correo soportan ambos métodos:
| Proveedor | URL | Mailto |
|---|---|---|
| Gmail | ✓ | ✓ |
| Yahoo | ✓ | ✓ |
| Outlook | ✗ | ✓ |
| Apple Mail | ✓ | ✓ |
| Proton Mail | ✓ | ✓ |
Outlook solo soporta el método mailto. Por eso recomendamos incluir siempre ambos para máxima compatibilidad.
¿Usas otro cliente de correo como Spark o Thunderbird? Entonces ese cliente determina si y cómo se muestra el header List-Unsubscribe.
List-Unsubscribe-Post
Desde 2017, existe un header adicional: List-Unsubscribe-Post, descrito en RFC 8058. Este header permite la cancelación con un clic directamente desde el cliente de correo. Cuando haces clic en "Cancelar suscripción" en la interfaz de Gmail por ejemplo, Gmail envía una solicitud POST a la URL. Así, el destinatario no necesita visitar una página web ni confirmar nada. Un clic y listo.
Este header solo tiene un valor posible:
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Ambos headers funcionan juntos. El primero indica dónde enviar la solicitud de cancelación, el segundo asegura que esto ocurra de forma segura y fiable. Juntos se ven así:
List-Unsubscribe: <https://example.es/cancelar?id=abc123>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Por qué Gmail y Yahoo exigen el header List-Unsubscribe
Desde junio de 2024, Gmail y Yahoo exigen el header List-Unsubscribe para todos los remitentes que envían más de 5.000 correos al día. Este requisito forma parte de un conjunto más amplio de reglas para mejorar la entregabilidad del correo y proteger a los destinatarios del spam.
Los requisitos son claros:
- El header List-Unsubscribe debe estar presente
- El header List-Unsubscribe-Post debe soportar la cancelación con un clic
- Las solicitudes de cancelación deben procesarse en dos días
No cumplir estos requisitos significa que tus correos pueden ser rechazados o terminar en la carpeta de spam. Por eso es importante configurar correctamente estos headers.

Cómo gestiona Lettermint el header List-Unsubscribe
El header List-Unsubscribe solo es necesario para correos de marketing y newsletters, también llamados Broadcast emails. Para Transaction emails como confirmaciones de pedido y restablecimientos de contraseña, una opción de cancelación no es necesaria y a menudo incluso indeseable.
Para los Broadcast emails enviados a través de Lettermint, no necesitas configurar el header List-Unsubscribe tú mismo. Nos encargamos de ello automáticamente, lo que te ahorra trabajo adicional y garantiza que tus correos cumplan con las directrices de proveedores como Gmail, Yahoo y Outlook.
Lo que Lettermint gestiona automáticamente
- Header List-Unsubscribe: añadimos una URL
- Header List-Unsubscribe-Post: soportamos la cancelación con un clic según RFC 8058
- Enlace de cancelación en el correo: cada Broadcast email contiene un enlace de cancelación visible al final
Cuando un destinatario cancela su suscripción a través del header o el enlace, lo procesamos inmediatamente. La dirección de correo se añade a tu lista de supresiones. Esto evita que se envíen nuevos correos a esa dirección a través de la ruta Broadcast.
Sincronizar cancelaciones con tu propio sistema
¿Quieres procesar las cancelaciones en tu propia base de datos? Es posible a través de:
- API: recuperar supresiones a través de nuestra API
- Webhooks: recibir una notificación cuando alguien cancela su suscripción
¿Usas tu propio sistema de cancelación?
En casos excepcionales, podemos desactivar el enlace de cancelación automático. Esto solo es posible si tienes tu propio sistema de cancelación completamente funcional. Entonces debes asegurarte de incluir un enlace de cancelación visible en tus correos y enviar tú mismo los headers List-Unsubscribe y List-Unsubscribe-Post correctos. Contacta con nuestro equipo de soporte.
Conclusión
El header List-Unsubscribe es una parte importante del email marketing. Ofrece a los destinatarios una forma fácil de cancelar su suscripción, reduce las quejas de spam y mejora tu reputación de remitente. Los grandes proveedores de correo como Gmail y Yahoo ahora exigen este header para remitentes masivos.
En Lettermint, no tienes que preocuparte por esto. Añadimos automáticamente los headers correctos a todos tus Broadcast emails y gestionamos las cancelaciones por ti. Así siempre cumples con las directrices y puedes centrarte en crear buen contenido.