Ir al contenido

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:

VariableQué poneEjemplo
contacto.nombreNombre del contacto del CRM; si el destinatario es una ficha del ERP, el nombre de la fichaAna López
contacto.nombre_completoNombre completo del contacto; en una ficha del ERP, su nombre fiscalAna López García
contacto.empresaEmpresa del contacto del CRMCerámicas del Norte
contacto.emailLa dirección a la que se manda el correoana.lopez@ejemplo.es
cliente.codigoCódigo de cliente de la ficha000123
cliente.nombreNombre comercial de la fichaCerámicas del Norte
cliente.nombre_fiscalNombre fiscal de la ficha (o el comercial si no tiene)Cerámicas del Norte, S.L.
cliente.poblacion, cliente.provinciaPoblación y provincia de la fichaBurgos

De tu empresa:

VariableQué pone
empresa.nombre, empresa.nifNombre y NIF de tu empresa
empresa.direccionTu dirección en una línea: «Calle de la Cerámica 12, 46001 Valencia»
empresa.telefono, empresa.webTeléfono y web
empresa.logo_urlDirección del logo de tu empresa, para una imagen

Del boletín y de la fecha:

VariableQué pone
campania.nombreNombre de la campaña del boletín
tematica.nombreTemática del boletín
fecha.hoyFecha del día en que sale el correo: «27/09/2026»

Enlaces propios de cada destinatario:

VariableAdónde lleva
enlace.bajaA darse de baja
enlace.preferenciasA elegir de qué temáticas recibir correo
enlace.navegadorA ver el correo en el navegador
enlace.confirmarA 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:

VariableQué poneEjemplo
documento.tipoTipo de documentoFactura de venta
documento.numeroNúmero, como se imprimeF-2026/000123
documento.fechaFecha del documento25/09/2026
documento.totalTotal, con su moneda1.234,56 €
documento.vencimientoPrimer vencimiento; vacío si no tiene25/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».

Con articulo y el código del artículo:

EscribesSale
`{{ "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:

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?

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)