Variables de las plantillas: qué datos se pueden poner en un correo
Una plantilla de mailing es el diseño de un correo. Dentro lleva variables: huecos como
{{ contacto.nombre }}que se rellenan con los datos de cada destinatario al mandarlo. Esta página dice qué variables hay, cómo se escribe un texto para cuando falta el dato y qué añade el correo por su cuenta.
¿Qué es una variable?
Es un hueco entre dobles llaves. Al mandar el correo, cada destinatario recibe su dato en ese hueco:
Hola {{ contacto.nombre }}, estas son las novedades de {{ empresa.nombre }}.
Ana López recibe «Hola Ana López, estas son las novedades de Alfarería del Turia». Las variables valen en el diseño, en el asunto y en el texto de vista previa (la línea que el lector de correo enseña bajo el asunto).
Las variables siguen Liquid, un lenguaje de plantillas muy extendido en las herramientas de correo. Solo se admiten las de esta página: una variable que no existe es un error, y el aviso dice en qué línea está.
En el diseño no se ven las llaves: cada variable sale como una pastilla con su nombre («Nombre del contacto», «NIF de tu empresa»). Con bloques se pone con la barra Insertar variable y las condiciones se eligen en los Ajustes de cada elemento; al escribir con el editor de texto, con su desplegable Variables. Lo de esta página es lo que hay debajo, y es lo que se escribe a mano en el Asunto, en el Texto de vista previa y en un correo pegado en código HTML. Está en cómo diseñar una plantilla y en las tres formas de escribir un correo.
¿Qué pasa si a un destinatario le falta el dato?
El hueco sale vacío. Para que no quede «Hola ,», añade un texto por defecto con default:
Hola {{ contacto.nombre | default: "cliente" }},
Quien tenga nombre lee su nombre; quien no, lee «Hola cliente,».
¿Cómo pongo un texto solo para algunos destinatarios?
Con if. Lo de dentro solo sale si la condición se cumple:
{% if cliente.codigo %}Tu código de cliente es {{ cliente.codigo }}.{% endif %}
{% else %} da el texto para quien no la cumple.
En el diseño no hace falta escribirlo: elige el elemento y, en sus Ajustes, pon Mostrar solo si con el dato y si tiene que tener valor o estar vacío. El programa lo guarda así.
¿Qué variables hay?
Del destinatario:
| Variable | Qué pone | Ejemplo |
|---|---|---|
contacto.nombre | Nombre del contacto del CRM; si el destinatario es una ficha del ERP, el nombre de la ficha | Ana López |
contacto.nombre_completo | Nombre completo del contacto; en una ficha del ERP, su nombre fiscal | Ana López García |
contacto.empresa | Empresa del contacto del CRM | Cerámicas del Norte |
contacto.email | La dirección a la que se manda el correo | ana.lopez@ejemplo.es |
cliente.codigo | Código de cliente de la ficha | 000123 |
cliente.nombre | Nombre comercial de la ficha | Cerámicas del Norte |
cliente.nombre_fiscal | Nombre fiscal de la ficha (o el comercial si no tiene) | Cerámicas del Norte, S.L. |
cliente.poblacion, cliente.provincia | Población y provincia de la ficha | Burgos |
De tu empresa:
| Variable | Qué pone |
|---|---|
empresa.nombre, empresa.nif | Nombre y NIF de tu empresa |
empresa.direccion | Tu dirección en una línea: «Calle de la Cerámica 12, 46001 Valencia» |
empresa.telefono, empresa.web | Teléfono y web |
empresa.logo_url | Dirección del logo de tu empresa, para una imagen |
Del boletín y de la fecha:
| Variable | Qué pone |
|---|---|
campania.nombre | Nombre de la campaña del boletín |
tematica.nombre | Temática del boletín |
fecha.hoy | Fecha del día en que sale el correo: «27/09/2026» |
Enlaces propios de cada destinatario:
| Variable | Adónde lleva |
|---|---|
enlace.baja | A darse de baja |
enlace.preferencias | A elegir de qué temáticas recibir correo |
enlace.navegador | A ver el correo en el navegador |
enlace.confirmar | A confirmar que quiere recibir tus correos: registra su consentimiento. Vale 30 días |
Se ponen como destino de un enlace: <a href="{{ enlace.baja }}">Darme de baja</a>.
enlace.confirmar es el botón del correo de la doble confirmación. En tus propias plantillas también registra el consentimiento de quien lo pulsa, pero una baja solo la levanta el correo que la propia persona pidió para volver.
Las variables de campaña, temática, baja, preferencias y confirmar son de las plantillas comerciales. Una plantilla de documento no las admite: un documento no se «da de baja».
¿Qué variables tienen las plantillas de documento?
Las del destinatario y las de tu empresa, más las del documento que va en el correo:
| Variable | Qué pone | Ejemplo |
|---|---|---|
documento.tipo | Tipo de documento | Factura de venta |
documento.numero | Número, como se imprime | F-2026/000123 |
documento.fecha | Fecha del documento | 25/09/2026 |
documento.total | Total, con su moneda | 1.234,56 € |
documento.vencimiento | Primer vencimiento; vacío si no tiene | 25/10/2026 |
El documento puede ser de cualquier ejercicio de tu empresa: una factura del año pasado sale con sus datos igual que una de este. Si el correo lleva varios, estas variables dicen el primero.
Cuando un correo lleva varios documentos de un mismo cliente (un envío que agrupa por cliente), documento.lista los tiene todos. Se recorren con for, y cada uno tiene tipo, numero, fecha, total y vencimiento:
{% for d in documento.lista %}
{{ d.numero }} del {{ d.fecha }}: {{ d.total }}<br />
{% endfor %}
¿En qué formato salen las fechas y los importes?
Con el de tu empresa: fechas como «27/09/2026» e importes con dos decimales y su moneda, «1.234,56 €». Los importes ya salen escritos: sirven para mostrarse, no para hacer cuentas con ellos.
Una fecha se puede escribir de otra forma con date:
{{ fecha.hoy | date: "%d de %B de %Y" }}
sale «27 de septiembre de 2026».
¿Cómo pongo un artículo del catálogo?
Con articulo y el código del artículo:
| Escribes | Sale | |
|---|---|---|
| `{{ "A001" \ | articulo: "nombre" }}` | El nombre del artículo |
| `{{ "A001" \ | articulo: "precio" }}` | Su precio de venta con IVA, con los decimales de tu empresa: «24,20 €» |
| `{{ "A001" \ | articulo: "imagen_url" }}` | La dirección de su imagen principal de la tienda web |
| `{{ "A001" \ | articulo: "enlace" }}` | La dirección de su página pública |
El precio es el de la ficha para cualquier cliente, IVA incluido: el mismo que enseña el verificador de precios. La imagen sale solo si el artículo tiene una imagen publicada en la tienda web o su ficha apunta a una imagen de internet. Powergest no publica una página por artículo, así que enlace sale vacío salvo que añadas tú el de tu tienda con default:
<a href="{{ "A001" | articulo: "enlace" | default: "https://www.tutienda.es/jarron-azul" }}">Ver</a>
Un código que no existe deja el hueco vacío: usa default también ahí.
En el diseño no hace falta escribirlo a mano: el bloque Artículo del catálogo pregunta qué artículo y pone la foto, el nombre y el precio con estas variables. Está en cómo diseñar una plantilla.
¿Qué añade el correo por su cuenta?
Aunque la plantilla no lo lleve, cada correo comercial sale con:
- El pie legal, si la plantilla no incluye
enlace.baja: una línea con el nombre, el NIF y la dirección de tu empresa, y el enlace para darse de baja. Lo exige la ley de comercio electrónico y no depende de que alguien se acuerde de ponerlo. Si tu plantilla ya lleva la baja, no se añade otra. - La baja en un clic en la cabecera del correo: los lectores de correo que la reconocen (Gmail, Apple Mail, Outlook) pueden enseñar junto al remitente un botón para cancelar la suscripción, que da de baja sin abrir ninguna página.
- Los enlaces preparados para contar clics: cada enlace a una web pasa primero por la dirección de tu Powergest, que anota el clic y lleva al destino. El destinatario llega a la misma página. No se tocan los enlaces de correo (
mailto:), de teléfono (tel:), de baja, de preferencias ni de ver en el navegador. - Una imagen invisible para contar aperturas, si el seguimiento de aperturas está activado en tu empresa.
- Una versión en texto, para los lectores de correo que no enseñan diseño.
Los correos de documentos llevan la versión en texto y el seguimiento, pero no el pie de baja ni el botón de cancelar suscripción, y pueden llevar el documento adjunto en PDF.
¿Qué no se puede poner en una plantilla?
- Imágenes pegadas dentro del correo (las que empiezan por
data:). Hacen el correo enorme y muchos lectores no las enseñan. Sube la imagen y usa su dirección. - Variables que no existen, o de otro tipo de plantilla. Es un error, y el aviso dice la línea.
Y un aviso que no impide guardar: si el correo pasa de 90 KB, Powergest te lo dice. Gmail corta los correos de más de 102 KB y esconde el final, que es justo donde están la baja y el seguimiento.
Relacionado: Mailing: boletines, grupos y a quién se le puede escribir · cómo diseñar una plantilla · las temáticas y las bajas por temática · por qué no le llega un boletín a alguien
Más sobre Mailing (campañas, envíos, seguimiento y envío de documentos)
- Boletines y grupos desde tus clientes, proveedores y contactos
- Campañas del mailing
- Cómo diseñar una plantilla de correo
- Consentimiento y base legal de cada dirección
- El control de un boletín: cómo va, pausar, reanudar y cancelar
- Gestionar las direcciones del mailing
- El servicio de envío del ERP: mandar tus boletines sin tu cuenta de correo
- Enviar facturas y otros documentos por correo
- Importar direcciones de mailing desde un fichero
- Mailing: boletines, grupos y a quién se le puede escribir
- La calidad de una dirección de correo
- La configuración del mailing: calidad, consentimiento, seguimiento y retención