Metafields de Shopify: Guía Completa para Comerciantes y Desarrolladores

Los metafields de Shopify son campos de datos personalizados que adjuntas a recursos existentes de tu tienda (productos, variantes, colecciones, pedidos, clientes) para almacenar información que el esquema predeterminado de Shopify no captura. Cualquier tema de Online Store 2.0 puede mostrar esos campos como fuentes dinámicas sin ediciones de código. Si alguna vez has necesitado mostrar una composición de tela, un tiempo de quemado, un período de garantía o una lista de ingredientes regulatoria en una página de producto, los metafields son la herramienta correcta.

Puntos clave

• Los metafields adjuntan datos extra a un recurso de Shopify existente, mientras que los metaobjects son registros independientes y reutilizables referenciados desde muchos lugares.
• La versión de API de Shopify 2026-04 agregó propagación automática de metafields de carrito a pedido, eliminando la mayor brecha en flujos de datos de checkout personalizados.
• El límite de valor por metafield bajó de 2 MB a 16 KB en abril de 2026, lo que significa que cualquier cosa más grande debe migrar a metaobjects o a la API de Archivos.
• Los límites de plataforma ahora son 256 definiciones de aplicación, 256 definiciones de comerciante y 1 millón de entradas por definición.
• El tipo article_reference (agregado en el lanzamiento de API 2025-10) te permite vincular productos directamente a publicaciones de blog para SEO impulsado por contenido.

¿Qué exactamente es un metafield de Shopify?

Un metafield es un par clave-valor estructurado que vive en un recurso de Shopify. Cada metafield tiene cuatro atributos obligatorios:

• Namespace, un contenedor lógico, por ejemplo custom o my_app
• Key, el identificador del campo dentro de ese namespace, por ejemplo fabric_type
• Type, el tipo de dato (texto, número, booleano, referencia de archivo, JSON, etc.)
• Value, los datos reales que estás almacenando

La combinación de namespace y key debe ser única por recurso. Shopify usa namespaces para prevenir colisiones entre campos propiedad de aplicaciones y campos propiedad del comerciante.

En Liquid, accedes a un metafield de producto con:

{{ product.metafields.custom.fabric_type.value }}

Para campos de texto enriquecido, usa el filtro metafield_tag para renderizar correctamente la salida HTML:

{{ product.metafields.custom.care_instructions | metafield_tag }}

Tipos de metafield soportados

Shopify soporta un amplio conjunto de tipos de contenido. Los más comúnmente usados son:

Los tipos article_reference y list.article_reference, agregados en la actualización de API 2025-10, te proporcionan una forma nativa de vincular productos a contenido editorial, lo que es una victoria clara para estrategias de SEO impulsadas por contenido.

Metafields vs. metaobjects: la decisión que necesitas acertar

Este es el error de arquitectura más común que veo en tiendas de clientes. La regla es simple:

Usa un metafield cuando los datos son únicos para un recurso específico y no tienen valor de reutilización.

Usa un metaobject cuando el mismo registro estructurado aparece en muchos recursos o necesita ser editado en un lugar y reflejarse en todas partes.

Un ejemplo real: un comerciante mayorista de ropa pegó la misma tabla de tamaños de 18 filas en 247 metafields de producto individuales. Cuando el estándar de tamaño cambió, 246 páginas de producto quedaron obsoletas mientras que una fue actualizada. Migrar esos datos a un único metaobject tomó 90 minutos. Ahora cada página de producto que lo referencia se actualiza en la siguiente solicitud desde una única edición.

Los metaobjects fueron introducidos en febrero de 2023 y están disponibles en cada plan de Shopify sin restricciones de plan. Piensa en una definición de metaobject como un esquema de tabla de base de datos, y cada entrada como una fila. Una definición Size_Guide podría tener campos para título, imagen y una tabla de medidas. Creas entradas (T-Shirt Size Guide, Jeans Size Guide) y las referencias desde tantos productos como necesites.

Matriz de decisión rápida:

• ¿Copia específica del producto que un comerciante edita por SKU? Metafield.
• ¿Tabla de tamaños compartida entre 50+ SKUs de ropa? Metaobject.
• ¿Plazo de envío estacional que varía por producto? Metafield.
• ¿Lista de distribuidores autorizados (nombre, región, URL) usada en todo el sitio? Metaobject.
• ¿Registro de miembro del equipo referenciado desde Acerca de, Carreras y publicaciones de blog? Metaobject.

El cambio de límite de 16 KB que no puedes ignorar (abril de 2026)

Este es el cambio de metafield más disruptivo de los últimos años. Shopify redujo el techo de valor por metafield de 2 MB a 16 KB, una reducción del 99.2%, que entró en vigor en abril de 2026. La justificación establecida es el costo de infraestructura de base de datos y el rendimiento.

Lo que esto significa en la práctica:

• Los metafields JSON usados como mini-bases de datos (común en integraciones de aplicaciones más antiguas) ahora están rotos o silenciosamente truncados si exceden 16 KB.
• Los bloques de texto enriquecido grandes o imágenes base64 incrustadas almacenadas en metafields deben moverse a la API de Archivos o ser reestructuradas como metaobjects.
• Las nuevas implementaciones deben diseñarse con 16 KB como el techo desde el primer día, apoyándose en metaobjects, referencias y la API de Archivos para cualquier cosa más pesada.

Si no estás seguro de si tu tienda se ve afectada, audita tus metafields a través de la API de GraphQL de Admin, consultando la longitud del campo value antes de cualquier migración.

La actualización de API 2026-04: los metafields de carrito ahora se trasladan a los pedidos

Esta es la noticia de metafield más grande para desarrolladores de 2026. La versión de API 2026-04 de Shopify introdujo la propagación automática de metafields de carrito a metafields de pedido cuando se cumplen ciertas condiciones.

El requisito práctico: el namespace y la key deben coincidir exactamente entre las definiciones de metafield del lado del carrito y del lado del pedido, y la capacidad cartToOrderCopyable debe estar habilitada en la definición de metafield del pedido.

Por qué esto importa para los comerciantes: las tiendas que recopilan datos personalizados en el checkout (tokens de personalización, banderas de mensaje de regalo, metadatos de lealtad, instrucciones de envío de terceros) anteriormente tenían que confiar en atributos de carrito o scripts de checkout personalizados para mantener esos datos visibles en el pedido resultante. Ese enfoque fragmentado ahora es reemplazado por un modelo de metafield unificado con permisos explícitos y controles de namespace. El resultado es controles de acceso más limpios para aplicaciones, menos casos especiales durante el checkout y un flujo de datos más predecible para flujos de trabajo de cumplimiento y reportes.

Si usas tuberías ETL para exportar pedidos para reconciliación de finanzas o ERP, actualiza tus asignaciones de campo para incluir los valores de metafield de pedido relevantes.

Cómo crear definiciones de metafield (sin código requerido)

1. Ve a Admin de Shopify > Configuración > Datos personalizados.
2. Elige el tipo de recurso (Productos, Variantes, Colecciones, Clientes, Pedidos, etc.).
3. Haz clic en Agregar definición.
4. Ingresa un nombre, namespace, key y selecciona el tipo de contenido.
5. Agrega validaciones opcionales (límites de caracteres, formato de URL, rangos numéricos).
6. Guarda.

Una vez que existe una definición, cualquier sección de tema Online Store 2.0 que soporte fuentes dinámicas la expondrá como un campo seleccionable en el editor de temas, sin necesidad de ediciones de Liquid.

Para población en masa, la importación CSV nativa de Shopify maneja un conjunto limitado de columnas de metafield. Para control total, Matrixify es la herramienta de facto: mapea columnas CSV directamente a pares namespace-key y valida tipos durante la importación.

Renderizar metafields en tu tema

Fuentes dinámicas (ruta sin código)

En el editor de temas, haz clic en cualquier bloque de texto, imagen o medio en una sección OS 2.0, luego haz clic en el icono Conectar fuente dinámica (el icono de base de datos). Tus metafields definidos aparecen como opciones. Esta es la ruta correcta para editores de contenido que no deben tocar código.

Liquid (ruta de código)

Para secciones personalizadas o lógica condicional, escribe directamente en Liquid:

{% if product.metafields.custom.is_hazardous.value %}
  <p class="hazard-notice">⚠ Maneja con cuidado. Consulta la hoja de seguridad.</p>
{% endif %}

{% assign warranty = product.metafields.custom.warranty_years.value %}
{% if warranty %}
  <p>Garantía de {{ warranty }} años incluida.</p>
{% endif %}

Shopify Flow (ruta de automatización)

Desde abril de 2024, Shopify Flow puede leer metafields tipados directamente. Seleccionas un recurso, eliges un metafield de la lista de definiciones conocidas, y Flow genera un alias que usas en pasos posteriores. Esto es útil para automatizar etiquetado, notificaciones o enrutamiento de cumplimiento basado en valores de metafield, sin aplicaciones personalizadas.

Metafields para SEO: la oportunidad de article_reference

El SEO impulsado por contenido es uno de los usos de mayor ROI de metafields en este momento. Con el tipo article_reference disponible desde el API 2025-10, puedes vincular un producto directamente a una publicación de blog específica desde dentro de la definición de metafield del producto. La URL de la publicación de blog se convierte en una referencia estructurada en lugar de una cadena codificada, lo que significa que sobrevive a cambios de handle y no requiere actualizaciones manuales en cientos de productos.

Esto importa para SEO porque crea una estructura de enlace interno navegable que los rastreadores pueden seguir, y mantiene el contenido editorial de apoyo contextualmente cerca de la página transaccional. Para tiendas con una biblioteca grande de guías de compra o artículos instructivos, vale la pena implementar esto sistemáticamente en tu catálogo.

Para una visión más amplia de cómo los datos estructurados y la organización del contenido afectan la visibilidad de búsqueda de tu tienda, consulta nuestras páginas de servicios de SEO de Shopify y desarrollo de temas de Shopify.

Límites de plataforma de un vistazo (actual a mediados de 2026)

Errores comunes a evitar

• Almacenar grandes blobs JSON en un único metafield. Desde abril de 2026 el techo es 16 KB. Usa metaobjects o divide los datos en campos tipados más pequeños.
• Duplicar datos compartidos en miles de productos. Si el mismo valor aparece en más de un puñado de productos, pertenece a un metaobject.
• Renombrar metafields en producción mientras el tema los referencia. Actualiza primero las referencias del tema, luego renombra la definición. Invertir ese orden rompe la salida en vivo de la tienda.
• Omitir definiciones y usar pares namespace-key sin procesar. Sin una definición, pierdes validación de tipo, soporte de fuente dinámica en el editor de temas y visualización limpia de interfaz de administración.
• Usar el namespace global. Las aplicaciones anteriormente usaban global.title y patrones similares. Ese namespace está reservado y su comportamiento es inconsistente en versiones de API. Usa un namespace personalizado.
• No auditar metafields heredados de aplicaciones. Las aplicaciones más antiguas dejan metafields huérfanos bajo namespaces como namespace_1 o apps.my_old_app. Estos cuentan contra tus límites de definición y contaminan la interfaz de administración.