Referencia de personalización de mensajes

Aprox. 18 min. de lectura

Actualizado el 8 ago 2025, 9:38 a.m. EST

Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo en tus mensajes de marketing y en Klaviyo Customer Hub para ofrecer una experiencia única a los suscriptores.

Las etiquetas de personalización se pueden usar en correos electrónicos (incluido el asunto), mensajes SMS o MMS, notificaciones push y Klaviyo Customer Hub. En este artículo, se describen algunas etiquetas disponibles, sus estructuras y formas, además de cómo personalizarlas. Para saber cómo hacerlo, consulta nuestro artículo sobre cómo personalizar tus mensajes.

Anteriormente, las etiquetas de personalización se llamaban “etiquetas de plantilla” y “sintaxis variable”.

Acerca de las etiquetas de personalización

Al introducir etiquetas en un campo de texto, estas son similares a la oración que se encuentra a la izquierda de la tabla siguiente. Una vez que se muestra el mensaje, las etiquetas se reemplazan por la información del perfil de los destinatarios o del evento, y tienen un aspecto parecido a la oración que se ubica a la derecha.

Hola, {{ first_name }} {{ last_name }}: tu color favorito es el {{ person|lookup:'Favorite Color' }}.

Hola, George Washington: tu color favorito es el verde.

La personalización del perfil suele empezar con person, a excepción de algunas etiquetas especiales como first_name y last_name. Las variables de evento, que pueden utilizarse en flujos activados por métricas, comienzan con event. Las etiquetas de organización (como el nombre y la dirección de tu empresa) empiezan con organization.

Todas las etiquetas de personalización distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con los nombres de las propiedades a las que hacen referencia. Asegúrate de que las etiquetas estén escritas correctamente y de que usen las mayúsculas y las minúsculas tal como aparece en tus perfiles.

Personalización del perfil

La personalización del perfil te permite mostrar propiedades especiales de Klaviyo en tus mensajes. La lista que se muestra a continuación cubre todas las personalizaciones del perfil (es decir, las propiedades integradas de Klaviyo). Algunas etiquetas de personalización del perfil están disponibles en el menú Personalización del editor de correo o en la ventana modal de vista previa para mensajes push y SMS.

Si quieres añadir propiedades personalizadas a tus mensajes, ve a la sección de personalización.

Etiqueta	Propiedades del perfil
`{{ email }}`	Correo electrónico
`{{ first_name }}`	Nombre
`{{ last_name }}`	Apellidos
`{{ person.organization }}`	Organización del destinatario
`{{ person\|lookup:"$address1" }}`	Dirección 1
`{{ person.id }}`	Unique ID ($id/external ID)
`{{ person\|lookup:"$latitude" }}`	Latitud
`{{ person\|lookup:"$longitude" }}`	Longitud
`{{ person.KlaviyoID }}`	Klaviyo ID
`{{ person.full_name }}`	Full name
`{{ person.title }}`	Título
`{{ person.phone_number }}`	Número de teléfono
`{{ person\|lookup:'$address2' }}`	Dirección 2
`{{ person.City }}`	Ciudad
`{{ person.Region }}`	Estado/región
`{{ person.Country }}`	País
`{{ person.Zipcode }}`	Código postal
`{{ person\|lookup:"$source" }}`	Fuente
`{{ person\|lookup:"$consent" }}`	Consentimiento
`{{ person\|lookup:'$consent_form_id' }}`	$consent_form_id
`{{ person\|lookup:'$consent_form_version' }}`	$consent_form_version
`{{ person\|lookup:'$consent_method' }}`	$consent_method
`{{ person\|lookup:"$timezone" }}`	Zona horaria del destinatario
`{{ person\|lookup:'$consent_timestamp' }}`	$consent_timestamp
`{{ person\|lookup:'$phone_number_region' }}`	$phone_number_region
`{{ person.ViewedItems }}`	Recently viewed items
`{{ person\|lookup:"Expected Date Of Next Order" }}`	Fecha prevista del próximo pedido

Etiquetas de objetos personalizados

Las etiquetas de objetos personalizados te permiten usar datos de objetos en envíos de flujos y campañas.

Revisa las referencias de etiquetas para ver ejemplos de cómo usar las etiquetas para obtener un ID de objeto o devolver un recuento.

Para poder usar datos de objetos personalizados en las plantillas, primero tienes que crear un objeto. La etiqueta {{ object }} solo está disponible cuando un objeto activó un flujo.

Etiqueta	Resultado
`{{ object.object_property }}`	Devuelve el objeto que activó un flujo
`{{ object \| lookup:'object_property' }}`	Devuelve el objeto que activó un flujo
`{{ object_filter.object_filter_name.object_property}}`	Devuelve un único objeto de un filtro de objetos
`{{ object_filter.object_filter_name \| lookup: 'object_property' }}`	Devuelve un único objeto de un filtro de objetos
`{{ object_filter.object_filter_name }}`	Devuelve un recuento de un filtro de objetos
`{% customobject id={{ event.object_id }} as alias %}`	Recuperar un objeto por su ID
`{% customobjects object_type_title=“Title” as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %}`	Recuperar todos los registros de un objeto de un perfil

Etiquetas de organización

Las etiquetas de la organización te permiten incluir información sobre tu empresa u organización en tus mensajes. Para administrar esta información, haz clic en el nombre de tu organización en la esquina inferior izquierda y, a continuación, selecciona Configuración > Organización > Información de contacto. Todas las etiquetas de la organización empiezan con organization. Consulta la siguiente tabla para ver la lista de etiquetas de la organización.

Etiqueta de organización	Descripción
`{{ organization.name }}`	Nombre de la organización
`{{ organization.url }}`	Sitio web de la organización
`{{ organization.full_address }}`	Dirección completa de la organización, lo que incluye la ciudad, el estado/región y el código postal
`{{ organization.street_address }}`	Dirección postal de la organización
`{{ organization.street_address2 }}`	La segunda parte de la dirección de la organización (p. ej., el número de apartamento o unidad)
`{{ organization.city }}`	Ciudad de la organización
`{{ organization.region }}`	Estado, provincia o región de la organización
`{{ organization.zip_code }}`	Código postal de la organización

Etiquetas de enlace y vista

Las etiquetas de enlace y vista previa permiten a los destinatarios administrar sus preferencias de suscripción y ver tu mensaje en sus navegadores. Entre ellas, se incluyen:

Desuscribirse
Administrar preferencias
Vista web
Texto de vista previa

Estas etiquetas solo se admiten para plantillas de correo electrónico. Si haces clic en uno de estos enlaces desde un correo electrónico de vista previa, se te dirigirá a una página de marcador de posición en lugar de una vista previa o página de consentimiento activa.

Desuscribirse

Klaviyo exige que se incluya en todos los correos electrónicos un enlace de cancelación de suscripción. Usa una etiqueta sencilla de cancelación de suscripción para un enlace que diga “Cancelar la suscripción”, o añade tu propio texto entre comillas.

Etiqueta	Salida
`{% unsubscribe %}`	Desuscribirse
Si ya no quieres recibir correos electrónicos, `{% unsubscribe 'click here' %}`.	Si ya no quieres recibir correos electrónicos, haz clic aquí.

También puedes utilizar la etiqueta {% unsubscribe_link %} para generar una URL de cancelación de suscripción. En lugar de generar un enlace con una palabra o frase, esta etiqueta solo crea la URL para cancelar la suscripción. Utiliza esta etiqueta si quieres emplear un color para el enlace de cancelación de suscripción distinto al que está establecido en los estilos de la plantilla o si quieres usar un botón o una imagen en lugar de un enlace de texto.

Etiqueta	Salida
`Este es un enlace sofisticado para <a href="{% unsubscribe_link %}" >cancelar la suscripción</a> .`	Este es un enlace sofisticado para cancelar la suscripción.

Cuando un destinatario hace clic en el enlace de cancelación de suscripción, se lo redirige a una página de confirmación personalizable.

Administrar preferencias

Las páginas de preferencias permiten a los destinatarios actualizar sus preferencias. Esto te ayuda a segmentar y dirigir tus mensajes de forma más eficaz. Si quieres incluir un enlace a esta página para cada destinatario, usa la etiqueta para administrar preferencias.

Puedes crear páginas de administración de preferencias generales y específicas para ciertas listas. Las páginas específicas de listas se usan cuando envías un mensaje solamente a una lista. Las páginas de administración de preferencias generales se usan cuando envías contenido a un segmento, a una combinación de listas y en flujos que no se activan por listas. Consulta más información sobre las páginas de administración de preferencias.

Usa una etiqueta de administración de preferencias sencilla para incluir un enlace con el texto “Administrar preferencias”, o bien añade tu propio texto entre comillas.

Etiqueta	Salida
`{% manage_preferences %}`	Administrar preferencias
¿Quieres actualizar tus preferencias? `{% manage_preferences 'Click here' %}`.	¿Quieres actualizar tus preferencias? Haz clic aquí.

También puedes utilizar la etiqueta {% manage_preferences_link %} para generar una URL de administración de preferencias. En lugar de generar un enlace con una palabra o frase, esta etiqueta solo crea la URL de la página de preferencias del destinatario. Utiliza esta etiqueta si quieres emplear un color para el enlace distinto al que está establecido en los estilos de la plantilla o si quieres usar un botón o una imagen en lugar de un enlace de texto.

Etiqueta	Salida
`Este es un enlace sofisticado para <a href="{% manage_preferences_link %}" >administrar preferencias</a>.`	Este es un enlace sofisticado para administrar preferencias.

Vista web

Puedes usar la etiqueta de vista web para ofrecer a los destinatarios la opción de ver un correo electrónico en su navegador web.

Etiqueta	Salida
`{% web_view %}`	Ver en el navegador
¿No puedes ver este correo electrónico? `{% web_view 'Open in your browser' %}`.	¿No puedes ver este correo electrónico? Abrir en el navegador.
`Este es un enlace sofisticado de <a href="{% web_view_link %}">vista web</a> .`	Este es un enlace sofisticado de vista web.

Texto de vista previa

En algunos casos, puede que quieras mostrar el texto de vista previa dentro del cuerpo de la plantilla. Puedes hacer referencia a cualquier texto de vista previa que hayas establecido en la pantalla de previsualización o configuración del correo electrónico utilizando la etiqueta {% render_variable preview_text %}.

Si modificas el texto de vista previa en la pantalla de vista previa del correo electrónico, esta etiqueta mostrará el texto de vista previa actualizado.

Etiquetas personalizadas y de eventos

Las etiquetas personalizadas hacen referencia a propiedades del perfil personalizadas (es decir, cualquier dato que recopiles sobre tus contactos que no sean propiedades y eventos especiales de Klaviyo), como el cumpleaños de alguien o sus preferencias de contacto. Las etiquetas de eventos hacen referencia a los datos de un evento específico (p. ej., un evento de pedido realizado) y solo se pueden usar en flujos activados por el evento en cuestión.

Para añadir una etiqueta personalizada, haz clic en Personalización en un campo de texto de correo electrónico y busca la etiqueta. Para añadir una etiqueta de evento, previsualiza tu mensaje y copia la etiqueta de variable de evento de los datos de previsualización. También puedes utilizar los formatos que se describen a continuación para añadir manualmente etiquetas personalizadas a tus plantillas.

Formato de la etiqueta	Descripción	Ejemplo
`{{ person.property_name }}`	Etiqueta sencilla de personalización del perfil	`{{ person.Birthday }}`
`{{ person\|lookup:'property name' }}`	Etiqueta de personalización del perfil, si el nombre de la propiedad contiene espacios o caracteres especiales	`{{ person\|lookup:'Favorite Color' }}`
`{{ event.property_name }}`	Etiqueta de variable de evento sencilla	`{{ event.URL }}`
`{{ event\|lookup:'property name' }}`	Etiqueta de variable de evento, si el nombre de la variable contiene espacios o caracteres especiales	`{{ event\|lookup:'$value' }}`
`{{ event.property.nested_variable }}`	Etiqueta de variable de evento, si la variable del evento está anidada en los datos del evento	`{{ event.extra.checkout_url }}`
`{{ event\|lookup:'property name'\|lookup:'nested variable name' }}`	Etiqueta de variable de evento, si la variable de evento está anidada en otra variable con un nombre que contiene un espacio o un carácter especial	`{{ event\|lookup:'Coupon Codes'\|lookup:'0' }}`

Utiliza la notación de puntos (.) para las etiquetas sin espacios ni caracteres especiales. Si los nombres de propiedades contienen espacios o caracteres especiales (p. ej., “$”), usa la notación de búsqueda.

Recuerda que, con las propiedades anidadas, si el nombre de una propiedad utiliza la notación de búsqueda, todas las propiedades posteriores también deberán utilizarla. Esto significa que, por ejemplo, event|lookup:'Collection Names'|lookup:'0' es correcto, pero event|lookup:'Collection Names'.0 no.

Personalizar etiquetas con filtros

Para personalizar la forma en la que aparecen las etiquetas, aplica filtros de plantilla. Los filtros pueden utilizarse para aplicar mayúsculas en las palabras significativas, establecer las posiciones decimales de un número y mucho más. Dos de los filtros más comunes son default y title.

El filtro default establece un valor por defecto para que aparezca si un destinatario del mensaje no tiene establecida esa propiedad. En el ejemplo que se muestra a continuación, “amigo” y “golosinas deliciosas” se establecen como valores por defecto en caso de que el nombre o la comida favorita del destinatario no estén establecidos en su perfil de Klaviyo.

Texto con etiquetas de personalización	Salida
Hola, `{{ first_name\|default:'friend' }}`, ¿te gustarían unas `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`?	Hola, amigo, ¿te gustarían unas golosinas deliciosas?

El filtro title te permite aplicar el formato de mayúscula inicial a cualquier etiqueta de texto para asegurarte de que se muestre con un formato coherente una vez enviado el mensaje. Por ejemplo, es posible que algunos suscriptores utilicen el formato de todo en mayúsculas o todo en minúsculas al rellenar tu formulario de registro. Si no usas ningún filtro, el nombre de cada suscriptor tendrá el formato (todo en mayúsculas o todo en minúsculas) que haya utilizado al rellenar tu formulario. Sin embargo, si usas el filtro “title”, corregirá el formato de mayúsculas o minúsculas para que su nombre aparezca correctamente.

Texto con etiquetas de personalización	Salida
Hola, `{{ first_name\|title }}`, ¿viste nuestro último lanzamiento?	Hola, Elise, ¿viste nuestro último lanzamiento?

Hay decenas de filtros adicionales disponibles para tus mensajes. Obtén más información sobre el uso de filtros para personalizar etiquetas.

Etiquetas de fecha

Las etiquetas de fecha te ofrecen una forma rápida de insertar información sobre fechas en un correo electrónico. La fecha está en la zona horaria de tu cuenta y refleja el día o la hora en la que se envía un mensaje.

La etiqueta {{ today }} es una de las etiquetas de fecha más comunes. Sirve para rellenar una marca de tiempo cuando se envía el mensaje. Para utilizar la etiqueta “today”, pega la siguiente línea de código en tu plantilla:

{% today "%Y-%m-%d" as today %} {{ today }}

Ten en cuenta que usar la etiqueta {{ today }} sin el código anterior no generará nada, ya que hace falta la línea de código completa.

Para saber cómo usar y personalizar las etiquetas de fecha, lee nuestro artículo sobre etiquetas de fecha en las plantillas.

Etiquetas de moneda

Los datos de eventos como Pedido realizado y Añadido al carrito, entre otros, suelen tener un valor financiero asociado (p. ej., el precio de un producto o el valor del carrito de un cliente). Usa la etiqueta {% currency_format … %} para aplicar el formato de moneda de tu país a ese valor.

Por ejemplo, fíjate en el campo $value de la métrica Pago iniciado que aparece a continuación:

Usando solo la variable {{ event|lookup:"$value" }}, esta propiedad se muestra con un solo decimal y sin símbolo de moneda en el correo electrónico:

Sin embargo, con la etiqueta de formato de moneda, {% currency_format event|lookup:"$value" %}, el número se presenta con un símbolo de moneda y el número correcto de decimales:

Para usar la etiqueta de formato de moneda, reemplaza el texto del marcador de posición en {% currency_format PLACEHOLDER %} por tu variable.

Por ejemplo, si tu variable es {{ event.item.price }}, la etiqueta de formato de moneda completa sería {% currency_format event.item.price %}. Si tu etiqueta incluye filtros (p. ej., un valor por defecto en caso de que la propiedad esté vacía), inclúyelos también en la etiqueta: {% currency_format event.item.price|default:”0” %}.

Cómo seleccionar un país

Puedes configurar el formato de moneda para tus mensajes de dos modos:

Para toda tu cuenta
Ve a Configuración > Organización > Idioma de la organización y formato regional y selecciona un idioma de la organización.
Para un mensaje concreto
Selecciona un formato de moneda diferente para un único mensaje en la pestaña Estilos de esa plantilla, en la sección Moneda.

Solución de problemas de la etiqueta “currency_format”

Esta etiqueta solo es compatible con variables numéricas (p. ej., 10 o 24.56). Las propiedades con el símbolo de moneda incluido (p. ej., $40, $76.30) son cadenas, y la etiqueta “currency_format” no puede alterarlas.

Declaraciones condicionales

Las etiquetas condicionales te permiten incluir contenido en tus mensajes para los destinatarios que cumplan determinados criterios y no incluirlo para los demás. También te ofrecen controles de alto potencial con los que puedes personalizar tus mensajes para cada destinatario.

Declaraciones “if”

Las declaraciones “if” te permiten controlar el contenido que alguien recibe en función de los datos de su perfil o de un evento.

En el ejemplo siguiente, el destinatario verá la primera línea de texto si tiene más de 150 puntos de fidelidad. Si tienen menos de 150, pero más de 0, verán la segunda línea. Y si no tienen puntos de fidelidad, verán el tercer mensaje.

{% if person|lookup:'Loyalty Points' > 150 %}
¡Hola, cliente VIP! Recuerda que siempre tienes envíos y devoluciones gratis
{% elif person|lookup:'Loyalty Points' > 0 %}
Tienes {{ person|lookup:'Loyalty Points' }} puntos, ¡y sólo necesitas 150 para convertirte en VIP! 
{% else %}
¿Conoces nuestro programa VIP? Únete hoy en nuestra web para empezar a ganar recompensas.
{% endif %}

Dentro de una declaración “if”, se requiere una condición {% if … %}, así como la etiqueta de cierre {% endif %}. Todos los demás elementos (es decir, las etiquetas {% elif %} y {% else %} ) son opcionales. Puedes utilizar un número ilimitado de etiquetas {% elif %}, seguido de una etiqueta {% else %}, como máximo. Cada destinatario de correo electrónico solo verá el primer mensaje para el que cumpla los requisitos.

Declaraciones “for”

Con los bloques “for”, puedes repetir cada elemento de una variable que está almacenando una lista y generarlos por separado. A continuación, se muestra un ejemplo de declaración:

{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}

Manta de playa extragrande × 1

Sillas de playa × 4

Protector solar SPF × 2

Nevera de plástico × 1

Cada declaración For debe contener lo siguiente:

Una etiqueta de apertura {% for … %} que contiene un alias de fila(item en el ejemplo anterior) y una colección de filas(event.shopping_cart_items en el ejemplo anterior)
Una etiqueta de cierre {% endfor %}

Entre las dos etiquetas obligatorias, puedes incluir el texto que quieras. Para incluir variables anidadas dentro de la colección de filas, reemplaza el principio del nombre de la variable (la colección de filas más el número que sigue) por tu alias de fila. Por ejemplo, la variable {{ event.shopping_cart_items.0.name }} se convertiría en {{ item.name }}.

Declaraciones condicionales y editor de texto integrado

Cuando añadas determinadas declaraciones condicionales a un bloque de texto, es posible que desaparezcan del editor de texto integrado. El código seguirá estando allí, pero oculto. Para ver y editar las sentencias condicionales, abre el campo Código fuente del bloque de texto.

Las siguientes etiquetas solo son visibles en el campo Código fuente de un bloque de texto:

{% for ... %}
{% endfor %}
{% if ... %}
{% elif ... %}
{% else %}
{% endif %}
{% with ... %}
{% endwith %}

Recursos adicionales

¿Te resultó útil este artículo?

Usa este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar al equipo de asistencia.

Descubre más sobre Klaviyo

Comunidad

Conecta con colegas, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.

Visita la comunidad

Capacitación en vivo

Únete a una sesión en tiempo real con expertos de Klaviyo para conocer las mejores prácticas, cómo configurar funciones clave y mucho más.

Regístrate ahora

Asistencia

Accede a la asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia virtual/por chat
La disponibilidad varía según la ubicación y el tipo de plan

Iniciar sesión