← RFC Reference

RFC 2369: Encabezados List-Unsubscribe y List-*

Current Standard Mailing Lists & Header Fields Published March 2026
ELI5: Cuando recibes una carta de una suscripción a una revista, generalmente hay un número de teléfono y una dirección para cancelar. RFC 2369 añade lo mismo al correo electrónico — encabezados estandarizados que le indican a los clientes de correo cómo desuscribirse, obtener ayuda, suscribirse o comunicarse con el propietario de la lista.

Por qué existe

Antes de RFC 2369, no había forma estándar de que los mensajes de listas de correo publicaran URLs de cancelación de suscripción o gestión. Los usuarios tenían que buscar en los pies de página del mensaje un enlace de cancelación de suscripción, si es que existía. Este RFC definió una familia de campos de encabezado List-* que los clientes de correo pueden analizar y presentar como elementos de interfaz de usuario (como el enlace "Darse de baja" de Gmail junto al nombre del remitente).

Hoy, estos encabezados son esenciales para el correo comercial. Gmail, Yahoo y Apple Mail usan List-Unsubscribe para mostrar botones de cancelación de suscripción de un clic. RFC 8058 luego extendió esto con un verdadero mecanismo POST de un clic.

Cómo funciona

Cada encabezado List-* contiene uno o más URI (entre corchetes angulares, separados por comas) que los clientes de correo pueden usar para la gestión de listas. El más importante es List-Unsubscribe, pero el RFC define un conjunto completo:

La familia completa de encabezados List-*

Encabezado Propósito
List-Unsubscribe URL(s) para darse de baja de la lista
List-Subscribe URL(s) para suscribirse a la lista
List-Help URL(s) para documentación de listas o ayuda
List-Post Dirección para enviar mensajes a la lista (o NO si no se permite publicar)
List-Owner Dirección de contacto del administrador de la lista
List-Archive URL del archivo de mensajes de la lista

Ejemplos de encabezados

; URL HTTPS y respaldo mailto
List-Unsubscribe: <https://example.com/unsub?id=abc123>,
    <mailto:unsub-abc123@example.com>

; Cancelación de suscripción de un clic (adición de RFC 8058)
List-Unsubscribe-Post: List-Unsubscribe=One-Click

; Otros encabezados List-*
List-Subscribe: <https://example.com/subscribe>
List-Help: <https://example.com/list-help>
List-Post: <mailto:discussion@example.com>
List-Owner: <mailto:listadmin@example.com>
List-Archive: <https://example.com/archive>

Esquemas URI

El RFC permite cualquier esquema URI, pero en la práctica se usan dos:

Cuando se proporcionan múltiples URI, el cliente de correo elige cuál usar. La mayoría de los clientes modernos prefieren HTTPS sobre mailto cuando List-Unsubscribe-Post está presente.

Detalles técnicos clave

Formato de encabezado correcto

Los URI deben estar entre corchetes angulares. Múltiples URI están separados por comas. Se permiten espacios en blanco y plegado de líneas según las reglas estándar de plegado de encabezados (RFC 5322).

Correcto:
List-Unsubscribe: <https://example.com/unsub?id=abc>, <mailto:unsub@example.com>

Incorrecto (faltan corchetes angulares):
List-Unsubscribe: https://example.com/unsub?id=abc

El URI mailto

Un URI mailto para cancelación de suscripción puede incluir un asunto o cuerpo:

List-Unsubscribe: <mailto:unsub@example.com?subject=unsubscribe-abc123>

El sistema receptor procesa el correo entrante para activar la cancelación de suscripción. Esto funciona incluso cuando el cliente de correo del destinatario no admite cancelación de suscripción basada en HTTPS.

List-Post: NO

Para listas de solo anuncio donde los destinatarios no pueden publicar, use el valor especial:

List-Post: NO

Errores comunes

Impacto en la capacidad de entrega

Related RFCs