---
title: "Cómo usar objetos personalizados en plantillas"
description: "Aprende a usar objetos personalizados en plantillas, para que puedas usar datos de objetos en envíos de flujos y campañas."
canonical_url: "https://help.klaviyo.com/hc/es-mx/articles/35146367972763"
markdown_url: "https://help.klaviyo.com/hc/es-mx/articles/35146367972763.md"
locale: "es-mx"
category: "Contenido"
section: "Utilizar objetos en Klaviyo"
updated: "2026-02-20"
---

# Cómo usar objetos personalizados en plantillas

**📋 Requirements:** Debes tener acceso a [objetos personalizados](https://help.klaviyo.com/hc/en-us/articles/35105337172123.md) para usar esta funcionalidad.

## Objetivos del artículo

Aprende a usar objetos personalizados en plantillas, para que puedas usar datos de objetos en envíos de flujos y campañas.

Debes [crear un objeto](https://help.klaviyo.com/hc/es-mx/articles/35105337172123.md) antes de poder usar datos de objetos personalizados en las plantillas. Para el menú de personalización, los filtros de objetos y las listas de registros de destinatarios, usa un objeto con una relación de perfil. Sus registros deben estar vinculados al destinatario para que aparezcan en su mensaje.

## Acceder a los datos de objetos desde el menú de personalización 

Puedes personalizar bloques de texto en el editor de plantillas de arrastrar y soltar usando propiedades de un objeto personalizado o el conteo de registros de un objeto.

Aprende [cómo usar el editor de plantillas de Klaviyo](https://help.klaviyo.com/hc/es-mx/articles/4407911841435.md). 

Si estás empezando con una plantilla HTML, primero puedes crear una copia de arrastrar y soltar:

1. Ve a **Contenido > Plantillas**, luego abre **Email: guardado**. Abre el menú de 3 puntos de la plantilla HTML y selecciona **Clonar a arrastrar y soltar**.

2. Abre **Plantillas convertidas** para revisar el progreso. Cuando el estado sea **Lista para usar**, haz clic en el nombre de la plantilla convertida para abrirla.

3. Revisa el diseño del texto y el contenido personalizado antes de usarlo. La plantilla HTML original no cambia.



Para empezar a agregar datos de objetos en las plantillas:

1. Agrega un nuevo bloque de texto o selecciona un bloque de texto existente.

2. Haz doble clic en el bloque de texto y luego coloca el cursor donde quieras insertar la propiedad dinámica. 

3. Selecciona el botón **Personalization** en la barra de herramientas de texto. 



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/e47231298041dbf92ae59635114d3a708b13480a-1600x454.jpg?auto=format)

4. En el modal de personalización, selecciona **Objetos** en el menú desplegable *Todos los tipos* .



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5c676687beaeeda39d7cc7c99ef82a33f8c2dc8c-550x884.png?auto=format)

5. Dentro de *Objetos*, verás todos los objetos de la cuenta que puedes usar para extraer datos a la plantilla. Selecciona el objeto que contiene los datos que te gustaría usar en la plantilla. 

6. Selecciona una propiedad para mostrar, o **Número de objetos** para mostrar un conteo. Después, selecciona un[ filtro de objetos](#h_01JPTH5R8840K0Q3XWH2CFYWRY). También puedes crear un nuevo filtro de objetos aquí.

7. Haz clic en **Insertar** después de seleccionar un filtro existente. Si creas un nuevo filtro, se inserta su etiqueta cuando terminas de crearlo.

8. Aplica los estilos de texto que necesites. Para un valor de propiedad, agrega texto predeterminado editando su etiqueta para incluir `|default:'value'`. Reemplaza `value` con el texto que quieres mostrar cuando la propiedad esté vacía.



Para especificar las reglas de uso de mayúsculas para los datos de objetos, deberás configurar manualmente la regla en la etiqueta de personalización. Por ejemplo, estas etiquetas usan el objeto que activó un flujo activado por fecha: 

- **{{ object.full_name|title|default:'value' }}**
John Doe 

- **{{ object.full_name|upper|default:'value' }}**
JOHN DOE

- **{{ object.full_name|lower|default:'value' }}**
john doe 



Más información sobre [cómo modificar valores con filtros de Django. ](https://developers.klaviyo.com/en/docs/glossary_of_variable_filters)

## Acceder a los datos de objetos con etiquetas de personalización

Puedes usar etiquetas de personalización en correos electrónicos (incluido el asunto del correo electrónico), mensajes SMS/MMS, notificaciones push y Klaviyo Customer Hub para mostrar datos de objetos.

Aprende [cómo usar etiquetas de personalización en Klaviyo](https://help.klaviyo.com/hc/es-mx/articles/18986347580827.md).

### Referencia de etiquetas de personalización de objetos

Puedes usar las siguientes etiquetas de personalización con objetos.

**Usar el objeto que activó un flujo**

**📝 Note:** {{ object }} solo está disponible cuando un objeto ha activado un flujo. La etiqueta de plantilla {{ object }} solo está disponible en flujos activados por fecha basados en un objeto. Esto es similar a la etiqueta de plantilla {{ event }} para flujos activados por evento.

Estos ejemplos usan lo siguiente:

- Objeto llamado *Mascota* que se referencia con la etiqueta *object* en la plantilla.  

- Propiedad de objeto llamada *Nombre*



| **Estructura** | **Ejemplo** |
| --- | --- |
| {{ object.object_property }} | {{ object.Name }} |
| {{ object \| lookup:'object_property' }} | {{ object \| lookup:'Name' }} |

**Recuperar un objeto por su ID**

Estos ejemplos usan lo siguiente:

- Objeto llamado *Mascota*

- Propiedad de objeto llamada *Nombre*

- Evento que activó el flujo con una propiedad de objeto llamada *pet_id*. Este campo es el mismo que el ID del objeto para el objeto *Pet*.



| **Estructura** | **Ejemplo** |
| --- | --- |
| {% customobject event.object_id  object_type_title="Title" as alias %} {{ alias.object_property }} {% endcustomobject %} | {% customobject event.pet_id  object_type_title="Pet" as pet %} {{ pet.Name }} {% endcustomobject %} |
| {% customobject event.object_id  object_type_title="Title" as alias %} {{ alias \| lookup:'object_property' }} {% endcustomobject %} | {% customobject event.pet_id  object_type_title="Pet" as pet %} {{ pet \| lookup:'Name' }} {% endcustomobject %} |

**Devuelve un único objeto de un filtro de objetos** 

Estos ejemplos usan lo siguiente:

- Un filtro de objeto adicional llamado *oldestDog*

- Propiedad de objeto llamada *Nombre*



| **Estructura** | **Ejemplo** |
| --- | --- |
| {{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
| {{ object_filter.object_filter_name \| lookup:'object_property' }} | {{ object_filter.oldestDog \| lookup:'Name' }} |

**Devuelve un número entero de un filtro de objetos** 

Estos ejemplos usan lo siguiente:

- Un filtro de objeto adicional llamado *countOfDogs*



| **Estructura** | **Ejemplo** |
| --- | --- |
| {{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |

**Devuelve varios objetos de un filtro de objetos**

Para un filtro llamado *dogs* configurado con **Múltiple**, recorre en bucle los registros coincidentes para mostrar la propiedad *Nombre* de cada mascota:

`{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}`

**Recupera registros de objetos**

Usa `customobjects` para recuperar hasta 5 registros vinculados al destinatario, ordenados del más reciente al más antiguo. Recorre esos registros devueltos para mostrar sus propiedades. Este ejemplo usa lo siguiente:

- Objeto llamado *perfil de mascota*

- Propiedad de objeto llamada *name*



| **Estructura** | **Ejemplo** |
| --- | --- |
| {% customobjects object_type_title="Title" as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} | {% customobjects object_type_title="Pet Profile" as pets %} {% for pet in pets %} {{ pet.name }} {% endfor %} {% endcustomobjects %} |

## Datos de objeto en asuntos

Usa la misma sintaxis de objeto personalizado en los asuntos que en el cuerpo del mensaje. Estos ejemplos muestran la sintaxis para cada fuente de datos:

- `{{ object_filter.oldestDog.Name }}` muestra la propiedad Name del filtro de objeto único oldestDog.

- `{{ object.Name }}` muestra la propiedad Name del objeto que activó un flujo activado por fecha.

- `{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}` busca un registro de Pet por ID. Úsalo en un flujo activado por un evento que contenga pet_id.



Por ejemplo, usa `{{ object.Name }}` en un flujo activado por fecha basado en el objeto Pet para mostrar el nombre de la mascota de un cliente en el asunto.

Vista de borrador:

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c3aa856db8d6b3ad6c963dd7dfed1ad85c8a6f49-1184x144.png?auto=format)

Vista previa del correo electrónico:

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/8689b7c75c09a03adc992c9840f820a4dedfbb06-1032x106.png?auto=format)

## Datos del objeto en la lógica de mostrar/ocultar

También puedes configurar si quieres mostrar u ocultar un bloque en una plantilla según los datos del objeto. Usa una propiedad o un recuento de un filtro de objetos, o del objeto que activó un flujo activado por fecha. Puedes usar los datos del objeto en una sola condición de mostrar/ocultar o en la condición de cada variante de lógica de mostrar/ocultar. Para los datos obtenidos por ID, usa la lógica condicional avanzada que se describe a continuación.

**📋 Requirements:** Debes crear filtros de objetos antes de poder hacer referencia a ellos en la lógica de mostrar/ocultar.

Por ejemplo, en un flujo activado por fecha basado en un objeto *Mascota*, usa `object.Breed == 'Labrador'` para mostrar un bloque solo cuando la *Raza* de la mascota activadora sea Labrador. Usa el valor exacto de la raza en tus datos.

1. Selecciona el bloque y abre la pestaña **Visualización**. En **Lógica de mostrar/ocultar**, selecciona **Mostrar solo a una audiencia específica** o selecciona **Personalizar para varias audiencias** para crear variantes de lógica. Luego, selecciona **Usar código**.

2. Ingresa una condición como `object_filter.countOfDogs > 0` sin `{{ }}` ni `{% %}` alrededor. Los filtros de objetos se pueden usar en campañas y flujos. Usa `object` solo en un flujo activado por fecha basado en datos del objeto.

3. Haz clic en **Guardar** para aplicar la condición.



![A custom-coded show/hide condition using an object filter.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/310cb57a4cb26bf4309bafea48d1d576c961ff1e-1232x617.png?auto=format)

Las secciones de objetos personalizados admiten la lógica de mostrar/ocultar para una sola audiencia. Las variantes de lógica no están disponibles para ellas. Obtén más información sobre las [variantes de lógica de mostrar/ocultar](https://help.klaviyo.com/hc/es-mx/articles/7655965301531.md#h_slv_multiple_audiences).

Para tener más flexibilidad (p. ej., hacer que cierta información sea condicional en función de la información devuelta por {% customobject %} o {% customobjects %}), considera usar [lógica condicional avanzada](https://help.klaviyo.com/hc/es-mx/articles/7655926841499.md) con la lógica {% if ... %} directamente en un bloque de texto.

## Filtros de objetos

### ¿Qué es un filtro de objetos?

Los filtros de objeto seleccionan registros vinculados a cada destinatario con los criterios que estableces. Puedes mostrar una propiedad de 1 registro coincidente, propiedades de hasta 10 registros coincidentes o un recuento de registros coincidentes.

### Crear un nuevo filtro de objetos

Para comenzar a crear un filtro de objetos:

1. Agrega un nuevo bloque de texto o edita el texto en un bloque de texto existente en la plantilla. 

2. Selecciona el botón **Personalización** . 



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/e47231298041dbf92ae59635114d3a708b13480a-1600x454.jpg?auto=format)

3. En el modal de personalización, selecciona **Objetos** en el menú desplegable *Todos los tipos* . 

4. Selecciona el objeto que contiene los datos para los que te gustaría establecer un filtro. 

5. Selecciona la propiedad que quieres mostrar. Para crear un filtro de recuento, selecciona **Número de objetos**.

6. Haz clic en **Crear** si aún no hay filtros. Si hay filtros en la lista, déjalos sin seleccionar y haz clic en **Crear filtro de objetos**.



En el modal *Crear filtro de objeto*, establece la siguiente información: 

- **Nombre**
Ingresa un nombre único que contenga solo letras y números, como oldestDog. No uses espacios ni caracteres especiales.

- **Establecer condiciones del filtro** 
Define las reglas que un objeto debe cumplir para incluirse en el bloque de texto. 

- **¿Cuántos objetos deben mostrarse?**
Para un valor de propiedad, selecciona **Único** para 1 registro o **Múltiple** para hasta 10 registros. Los filtros de conteo no muestran esta configuración.

- **Selecciona la propiedad** y **Orden de clasificación**
Para un filtro de propiedad-valor, elige la propiedad que se usa para seleccionar u ordenar registros y, luego, elige el orden de clasificación. Por ejemplo, ordena por una propiedad de cumpleaños con **Más antiguo** para seleccionar primero a la mascota de mayor edad. Estos campos no aparecen para filtros de conteo.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7d5bbdab8163c4d029f8c9bfc6eba9c660e0855c-1288x1096.png?auto=format)

Haz clic en **Crear filtro de objeto** para guardar el filtro e insertar su etiqueta en el bloque de texto.

Una vez creado el filtro de objetos, puedes usarlo en la lógica de mostrar/ocultar y en etiquetas de personalización para mostrar registros de objetos específicos según los criterios que configures.

## Recursos adicionales

- [Primeros pasos con objetos personalizados](https://help.klaviyo.com/hc/es-mx/articles/35105337172123.md)
  Obtén más información sobre los objetos personalizados, que te permiten almacenar y asociar varias propiedades a un solo "objeto". Los objetos personalizados te permiten asignar conceptos de datos diversos y multirelacionales a Klaviyo que no pueden almacenarse utilizando propiedades del perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y mucho más. 

- [Guía de personalización de mensajes](https://help.klaviyo.com/hc/es-mx/articles/4408802648731.md)
  Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo para ofrecer una experiencia personalizada a tus clientes.

- [Cómo usar el panel de vista previa para la personalización de mensajes](https://help.klaviyo.com/hc/es-mx/articles/27843522951707.md)
  Aprende a usar el panel de vista previa para entender los datos de personalización disponibles para tus mensajes y cómo acceder a las etiquetas de plantilla. Usa el modal de vista previa como tu fuente de verdad para las opciones de personalización. 
