Saltar al contenido

Metaobjetos de Shopify: contenido editable sin tocar el código del tema

En la práctica/ 11 min de lectura

Metaobjetos de Shopify para FAQ, tablas de tallas y testimonios: defines los campos, llenas las entradas en el admin y las lees en una sección Liquid.

  • Shopify
  • Liquid
  • Temas
En este artículo (9)
  1. Qué son los metaobjetos de Shopify
  2. Definir los campos: FAQ, tabla de tallas y testimonios
  3. Llenar las entradas desde el admin
  4. Recorrer los metaobjetos en Liquid
  5. Conectarlos a una sección del tema
  6. Cuándo usar metacampos y cuándo metaobjetos
  7. Errores comunes
  8. Preguntas frecuentes
  9. Checklist

Los metaobjetos de Shopify guardan contenido estructurado, como preguntas frecuentes, tablas de tallas o testimonios, fuera del código del tema. Defines los campos una vez, el equipo llena las entradas desde el admin y el tema las lee en Liquid con metaobjects.tipo.values o con un ajuste metaobject_list en la sección.

Aquí tienes el ejemplo completo con una sección de preguntas frecuentes: la definición, las entradas, la sección en Liquid y cuándo conviene un metacampo en lugar de un metaobjeto. El código pasó shopify theme check en un tema de prueba local; no lo corrimos contra una tienda real.

Qué son los metaobjetos de Shopify

El síntoma es conocido: las preguntas frecuentes están escritas a mano dentro de un archivo .liquid, la tabla de tallas es una imagen pegada en la descripción de cada producto y cambiar una respuesta exige abrir el editor de código. Cada cambio de texto pasa por quien sabe Liquid, y el riesgo de romper el tema es el mismo que si se cambiara la lógica.

La documentación de Shopify define un metaobjeto como una instancia de datos estructurados con varios campos relacionados. Hay dos piezas:

  • La definición es el esquema: el tipo (por ejemplo faq), los campos, sus tipos de dato y las reglas de validación.
  • Las entradas son los registros que siguen esa definición: una por pregunta, una por tabla de tallas, una por testimonio. Cada entrada tiene un handle único.

A diferencia de un metacampo, un metaobjeto no pertenece a un producto ni a una colección: existe por su cuenta y lo puedes referenciar desde varios lugares. El tema solo lee. El equipo edita el contenido desde el admin, y el código del tema deja de cambiar cada vez que cambia un texto.

de la definición al tema, sin tocar código1 · definiciónfaq· question· answerConfiguración >Datos personalizados2 · entradasenviosdevolucionespagosContenido >Metaobjetos3 · temametaobject_listmetaobjects.faq.valuessecciónfaq-metaobjectsel admin guarda los datos; el tema solo los leecambiar una respuesta ya no pasa por el códigodefinición, entradas y tema: tres capasrutas del admin según la ayuda de Shopify

Desliza la figura para verla completa

Definir los campos: FAQ, tabla de tallas y testimonios

La definición se crea en Contenido > Metaobjetos o en Configuración > Datos personalizados (una de las páginas de ayuda lo llama Metafields and metaobjects). Según la guía para crear un metaobjeto, pulsas Add definition, escribes el nombre (el tipo se genera solo y lo puedes editar antes de guardar) y agregas campos con Add field, eligiendo el tipo de cada uno. Estas son tres definiciones que cubren los casos más comunes en una tienda:

Definición (tipo)Campo (clave)Tipo de dato
Pregunta frecuente (faq)questionsingle_line_text_field
answerrich_text_field
Tabla de tallas (size_chart)titlesingle_line_text_field
imagefile_reference (imagen)
notesmulti_line_text_field
Testimonio (testimonial)authorsingle_line_text_field
quoterich_text_field
productproduct_reference

Tres decisiones que conviene tomar aquí, no después:

  • La clave del campo es la que usará Liquid. question se lee como faq.question.value. Cámbiala más tarde y tendrás que tocar el tema.
  • El texto enriquecido no tiene tablas. La lista de tipos de dato dice que rich_text_field admite encabezados, listas, enlaces, negritas y cursivas. Por eso la tabla de tallas lleva una imagen y unas notas, no una tabla en texto enriquecido.
  • El acceso desde la tienda. En la sección Access, la opción Storefronts viene marcada; la ayuda explica cómo desmarcarla. Déjala marcada: un ajuste de tema que apunte a la definición la necesita disponible para la tienda.

Shopify también trae definiciones estándar con el prefijo shopify--, como shopify--material. Si una de ellas ya cubre tu caso, úsala antes de crear la tuya.

Llenar las entradas desde el admin

Las entradas se crean en Contenido > Metaobjetos: entras a la definición, pulsas Add entry, llenas los campos y guardas. Lo que la ayuda sobre entradas deja claro:

  • Cada entrada recibe un handle automático, legible y único dentro de su tipo, por ejemplo envios. Se puede editar con el lápiz, salvo cuando la definición publica sus entradas como páginas web.
  • Cambiar un handle que ya está en uso rompe las referencias puestas a mano, incluidas las de Liquid.
  • Las entradas nuevas quedan en Active. Una entrada en Draft no se publica.

Para conectar entradas a un producto, crea un metacampo de producto de tipo metaobjeto en Configuración, elige la definición faq y marca List of values si el producto lleva varias preguntas, como explica la ayuda sobre referenciar metaobjetos. Después, en la ficha del producto, eliges las entradas con Select entry. En el ejemplo, ese metacampo es custom.faqs y su tipo es list.metaobject_reference.

ejemplo: una pregunta frecuente como metaobjetodefinición · faqquestionsingle_line_text_fieldanswerrich_text_fieldel molde: claves y tiposentrada · enviosquestion¿Cuánto tarda el envío?answerEntre 2 y 5 días hábiles.{% for faq in metaobjects.faq.values %} {{ faq.question.value | escape }} {{ faq.answer | metafield_tag }}dos campos, una entrada por preguntatexto de la entrada: ilustrativo

Desliza la figura para verla completa

Recorrer los metaobjetos en Liquid

Hay tres formas de llegar a una entrada desde Liquid, todas en la referencia de los objetos metaobject y metaobject_definition:

  • Por handle: metaobjects.testimonial.home o metaobjects['testimonial']['home'].
  • Todas las de un tipo: metaobjects.faq.values, con metaobjects.faq.values_count para el total.
  • Por referencia: product.metafields.custom.faqs.value devuelve las entradas que se eligieron en ese producto.

Antes se escribía shop.metaobjects.faq.values. Desde el 28 de enero de 2025 la forma preferida es metaobjects.faq.values; la anterior sigue funcionando por compatibilidad. Dos fragmentos que pasaron theme check:

{%- assign chart = product.metafields.custom.size_chart.value -%}
{%- if chart != blank -%}
  <div class="size-chart">
    <h3>{{ chart.title.value | escape }}</h3>
    {{ chart.image | metafield_tag }}
    {{ chart.notes | metafield_tag }}
  </div>
{%- endif -%}

{%- paginate metaobjects.faq.values by 100 -%}
  {%- for faq in metaobjects.faq.values -%}
    <p>{{ faq.question.value | escape }}</p>
  {%- endfor -%}
  {{ paginate | default_pagination }}
{%- endpaginate -%}
  1. product.metafields.custom.size_chart.value lee un metacampo de producto de tipo metaobject_reference. Con .value obtienes la entrada; sin él, tienes el metacampo.
  2. != blank evita pintar un bloque vacío en productos sin tabla.
  3. Cada campo de la entrada es a su vez un metacampo: chart.title.value es el texto, que se escapa antes de imprimirlo.
  4. metafield_tag recibe el campo, no su .value. Para una imagen genera un <img> con loading="lazy"; para texto de varias líneas, un <span> con saltos de línea.
  5. Un for recorre como máximo 50 entradas. Con paginate, metaobjects.faq.values admite páginas de hasta 250, según la documentación de paginate.
  6. default_pagination pinta los enlaces a la página siguiente y anterior.

Dos detalles más del objeto system: faq.system.handle y faq.system.type sirven para distinguir entradas en una lista mixta, y system.url solo existe si la definición publica sus entradas como páginas web.

Conectarlos a una sección del tema

El paso que más tiempo ahorra: un ajuste de sección de tipo metaobject_list. Con él, quien edita la tienda elige en el editor de temas qué preguntas aparecen y en qué orden, sin tocar código. La referencia de ajustes pide metaobject_type, admite un limit opcional cuyo valor por defecto y máximo es 50, y devuelve blank si no hay selección. Esta es la sección completa, sections/faq-metaobjects.liquid:

{%- liquid
  assign faqs = section.settings.faqs
  if faqs == blank
    assign faqs = product.metafields.custom.faqs.value
  endif
  if faqs == blank
    assign faqs = metaobjects.faq.values
  endif
-%}

{%- if faqs != blank -%}
  <section class="faq">
    {%- if section.settings.heading != blank -%}
      <h2>{{ section.settings.heading | escape }}</h2>
    {%- endif -%}
    {%- for faq in faqs -%}
      <details class="faq__item">
        <summary>{{ faq.question.value | escape }}</summary>
        {{ faq.answer | metafield_tag }}
      </details>
    {%- endfor -%}
  </section>
{%- endif -%}

{% schema %}
{
  "name": "FAQ (metaobjects)",
  "settings": [
    {
      "type": "text",
      "id": "heading",
      "label": "Heading",
      "default": "Frequently asked questions"
    },
    {
      "type": "metaobject_list",
      "id": "faqs",
      "label": "Questions",
      "metaobject_type": "faq",
      "limit": 20
    }
  ],
  "presets": [{ "name": "FAQ (metaobjects)" }]
}
{% endschema %}

Línea por línea:

  1. El bloque liquid decide de dónde salen las preguntas. Primero, las que se eligieron en el editor con el ajuste faqs.
  2. Si no hay selección, prueba con el metacampo custom.faqs del producto. Fuera de una página de producto, product no existe y la condición sigue en blank.
  3. Si tampoco hay, usa todas las entradas del tipo faq. Con la capacidad publishable activa, las entradas en borrador no aparecen.
  4. {%- if faqs != blank -%} no pinta nada si no hay preguntas, ni siquiera el título.
  5. Cada pregunta es un <details> con su <summary>: se abre con teclado y lector de pantalla sin escribir JavaScript.
  6. faq.question.value | escape imprime la pregunta como texto; faq.answer | metafield_tag imprime el texto enriquecido como un <div class="metafield-rich_text_field">.
  7. En el esquema, metaobject_type: "faq" limita el selector a ese tipo y limit: 20 deja elegir hasta 20, por debajo del máximo de 50.
  8. presets permite agregar la sección desde el editor de temas.

Dos límites del ajuste: solo admite un tipo por ajuste, y si la definición no existe en la tienda o no está disponible para la tienda online, el editor de temas muestra un error. Para temas de la Theme Store, Shopify no permite definiciones propias en estos ajustes, solo las estándar; en el tema de tu tienda no hay esa restricción. Si quieres ver cómo encaja esto en un tema que dure, lee arquitectura de temas de Shopify que aguanta un año.

Cuándo usar metacampos y cuándo metaobjetos

Los dos usan los mismos tipos de dato, pero resuelven cosas distintas. Un metacampo agrega un dato a un recurso que ya existe. Un metaobjeto crea un tipo de contenido propio que se reutiliza.

MetacampoMetaobjeto
Qué esUn campo extra en un producto, colección, cliente o pedidoUn tipo propio con varios campos
Dónde se editaEn la ficha del recursoEn Contenido > Metaobjetos
ReutilizaciónUn valor por recursoUna entrada, muchas referencias
En Liquidproduct.metafields.custom.material.valuemetaobjects.faq.values
EjemploEl material de una camisetaLa tabla de tallas que comparten 40 camisetas (ilustrativo)

La regla práctica: si el mismo contenido se repite en varios productos, o si tiene más de un campo, es un metaobjeto y el producto lo referencia con un metacampo. Si es un dato que solo tiene sentido en un recurso, basta un metacampo. Y si el dato lo escribe el comprador durante la compra, no es contenido del tema: eso va en el checkout, como en campo extra en el checkout de Shopify con una checkout UI extension.

metacampo o metaobjeto: cuál usarmetacampometaobjetoqué esun campo en un recursoun tipo propio con camposdónde viveen producto, colección…Contenido > Metaobjetosse reutilizano: un valor por recursosí: una entrada, n referenciasen Liquidproduct.metafields.ns.keymetaobjects.tipo.handleejemplomaterial del productotabla de tallas compartidasi el contenido se repite en varios recursos, es un metaobjetoel metacampo extiende, el metaobjeto se reutilizasegún la documentación de datos personalizados de Shopify

Desliza la figura para verla completa

Errores comunes

  • Olvidar .value. faq.question es el metacampo; faq.question.value es el texto. Al revés con metafield_tag: recibe el metacampo, no el valor.
  • Entradas en borrador que "no salen". Con publishable activo, una entrada en Draft devuelve nil y los bucles la saltan.
  • Cambiar el handle de una entrada en uso. Rompe metaobjects.testimonial.home y cualquier referencia puesta a mano.
  • Esperar más de 50 entradas en un for. Usa paginate sobre .values.
  • Contar una lista de referencias con size. En listas de referencias se usa .count, por ejemplo product.metafields.custom.faqs.value.count.
  • Quitar el acceso de la tienda online a la definición. El ajuste metaobject_list deja de funcionar en el editor.
  • Borrar una definición conectada al tema publicado. Se borran todas sus entradas, no se puede deshacer y la tienda muestra errores.
  • Meter una tabla en texto enriquecido. El tipo no la admite; usa una imagen, una lista o un campo por columna.

Preguntas frecuentes

¿Puedo mostrar más de 50 entradas de un metaobjeto?

Sí. Un for se detiene en 50, pero metaobjects.tipo.values admite paginate con páginas de hasta 250 entradas. Acceder por handle no sirve para esto: el límite es de 20 handles únicos por página y no se puede paginar.

¿Por qué una entrada existe en el admin pero no aparece en la tienda?

Revisa tres cosas: que esté en Active y no en Draft, que su handle sea el que usa el código y, si viene de un ajuste de sección, que esté elegida en el editor de temas. Si el editor muestra un error en el ajuste, la definición no está disponible para la tienda.

¿Sirve en un tema de la Theme Store?

Con definiciones propias, no en los ajustes del tema: la Theme Store solo admite definiciones estándar en metaobject y metaobject_list. En el tema propio de tu tienda puedes usar las tuyas sin problema.

¿shop.metaobjects o metaobjects?

metaobjects. Shopify lo publicó en su changelog el 28 de enero de 2025 como la forma preferida. shop.metaobjects sigue funcionando, así que no hace falta reescribir un tema que ya lo usa, pero el código nuevo va sin shop..

Checklist

  • La definición tiene claves cortas y estables: question, answer.
  • El tipo de cada campo coincide con lo que vas a mostrar; nada de tablas en texto enriquecido.
  • El acceso de la tienda online sigue marcado.
  • Las entradas están en Active y sus handles no cambian una vez en uso.
  • El metacampo del producto es list.metaobject_reference si lleva varias entradas.
  • El código usa metaobjects.tipo, con .value para leer y metafield_tag sobre el campo.
  • La sección tiene un ajuste metaobject_list con limit de 50 o menos.
  • Más de 50 entradas pasan por paginate.
  • shopify theme check pasa sin errores antes de subir el tema.

Para lo que viene después en la forma de armar secciones con Liquid, lee Liquid estrena las etiquetas block y partial.

¿Viste esto en Instagram? Comenta METAOBJETOS en el Reel y te mando la guía.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 19 de noviembre de 2026

← Blog