Metafields de Shopify: Guía completa de configuración y visualización

Un metafield de Shopify es un campo personalizado clave-valor que adjuntas a un recurso de tu tienda (producto, colección, pedido, cliente, variante, etc.) para almacenar datos que el esquema principal de Shopify no proporciona de forma nativa. Defines el tipo de dato, aplicas validación, y luego expones el valor en cualquier lugar: tu tienda mediante Liquid, tu análisis mediante ShopifyQL, tu checkout mediante Shopify Functions, o tus sistemas externos mediante la API GraphQL Admin. Ese ciclo de tres pasos (definir, completar, mostrar) es todo el modelo mental que necesitas.

Puntos clave

• Un metafield se identifica por tres cosas: recurso propietario, espacio de nombres y clave. Cambia cualquiera de estos y estarás haciendo referencia a un campo diferente.
• Las ediciones Spring '26 y Summer '26 de Shopify incluyeron varias mejoras de metafields: fijar hasta 50 campos en páginas de administración, metafields de carrito que se transfieren a pedidos, metafields en transferencias de inventario, y filtrado con sintaxis de puntos en ShopifyQL.
• La versión candidata de API GraphQL Admin 2026-07 te permite definir y establecer metafields directamente en transferencias de inventario sin una llamada separada a metafieldsSet.
• Crear una definición no muestra nada en tu tienda. Aún necesitas conectar el campo mediante una fuente dinámica en el editor de temas, o escribir el Liquid tú mismo.
• Las definiciones estándar (instrucciones de cuidado, ingredientes, tamaño, ISBN, etc.) son el camino más rápido porque vienen preconfiguradas, son compatibles con temas y funcionan con aplicaciones sin necesidad de configuración adicional.

¿Qué exactamente es un metafield de Shopify?

Los metafields te permiten adjuntar información adicional a un recurso de Shopify, como un producto o una colección. Los datos pueden ser especificaciones, tablas de tallas, documentos descargables, fechas de lanzamiento, imágenes o números de pieza. Cada metafield almacena un valor junto con información de tipo, e se identifica por su recurso propietario, espacio de nombres y clave.

Piensa en el espacio de nombres como el nombre de una carpeta y la clave como el nombre del archivo dentro de esa carpeta. Un metafield de producto con namespace: custom y key: material es completamente separado de uno con namespace: specs y key: material, aunque ambos vivan en el mismo producto.

Los tres modelos de propiedad

Entender la propiedad te evita sobrescribir datos que no tenías intención de modificar.

Los metafields propiedad del comerciante utilizan cualquier espacio de nombres no reservado (como custom, specs o inventory). Todas las aplicaciones instaladas pueden leerlos y escribir en ellos. Son ideales para datos compartidos que múltiples aplicaciones consumen.

Los metafields propiedad de la aplicación utilizan el prefijo de espacio de nombres reservado $app. La aplicación propietaria controla la estructura y los valores, que son de solo lectura en el administrador por defecto. Úsalos cuando una aplicación es la fuente autorizada para una pieza de datos.

Los metafields datos de aplicación están vinculados a una instalación de aplicación específica y están completamente ocultos en el administrador de Shopify. Viven en el recurso AppInstallation y solo pueden ser accedidos por la aplicación propietaria mediante GraphQL o a través del objeto app en Liquid. Estos son para estado interno de la aplicación que nunca debe mostrarse a los comerciantes.

Shopify también mantiene espacios de nombres reservados por Shopify (con prefijo shopify--) para campos gestionados por la plataforma como definiciones estándar.

Tipos de datos de metafields: un mapa práctico

Shopify agrupa los tipos en categorías. Elegir el tipo correcto es importante porque aplica validación, controla cómo Liquid renderiza el valor, y determina qué filtros se aplican.

Texto

• single_line_text_field, insignias de producto, etiquetas cortas, códigos ISO
• multi_line_text_field, listas de ingredientes, instrucciones de cuidado (saltos de línea preservados)
• rich_text, contenido largo formateado (encabezados, negrita, listas); renderiza con el filtro metafield_tag

Números y medidas

• number_integer, number_decimal
• dimension, volume, weight, cada uno almacena un valor numérico emparejado con una unidad; ideal para especificaciones de productos y reglas de envío

Fechas y horas

• date, date_time, fechas de lanzamiento, fechas de vencimiento, horarios de eventos

Referencias

• product_reference, collection_reference, page_reference, variant_reference, vincula un recurso a otro sin duplicar datos
• metaobject_reference, vincula a una entrada de metaobject (ver abajo)
• article_reference y list.article_reference, agregados en la versión de API 2025-10; te permiten vincular productos directamente a publicaciones de blog para comercio dirigido por contenido y SEO

Otros tipos útiles

• boolean, banderas de características, toggles de "nuevo artículo", marcadores de ocultar de venta
• color, valores de color basados en hexadecimal con soporte de muestra nativa
• url, file_reference, PDFs descargables, hojas de especificaciones, vídeos
• json, datos estructurados arbitrarios; útil pero más difícil de validar y renderizar

Para tipos de lista, prefija cualquier tipo escalar con list. (por ejemplo, list.single_line_text_field). Estos se renderizan como matrices en Liquid y son la opción correcta cada vez que un campo puede contener múltiples valores, como una lista de materiales o un conjunto de ubicaciones de recogida.

Una restricción importante: al usar la API GraphQL Admin, el valor del metafield siempre se ingresa y almacena como una cadena, independientemente del tipo declarado. Shopify maneja la coerción de tipos al leer.

Definiciones de metafields: por qué son importantes

Puedes escribir un metafield sin procesar (sin definición) a través de la API, pero las definiciones casi siempre son la opción correcta. Una definición de metafield establece un esquema que todos los valores para esa combinación de espacio de nombres-clave deben seguir, incluyendo el tipo de dato y restricciones de validación. La definición también controla los permisos de acceso en toda la API GraphQL Admin, API Storefront, y API de Cuenta del Cliente, y determina si el campo puede usarse para filtrado de administración o como condición de colección.

Construir con definiciones significa:

• Soporte de interfaz de administración. Los campos definidos aparecen en la página de edición de cada recurso relevante sin ningún código personalizado.
• Validación. Los valores no válidos se detectan antes de que corrompan tu tienda.
• Filtrado. Puedes usar un campo definido como condición de colección inteligente o como filtro de administración.
• Descubrimiento del editor de temas. Los selectores de fuentes dinámicas solo muestran campos definidos.

Las definiciones estándar son esquemas preconstruidos para casos de uso comunes como números ISBN, ingredientes de productos e instrucciones de cuidado. Usarlos significa que las aplicaciones y temas que hacen referencia a esos espacios de nombres estándar ya sabrán cómo leer tus datos sin configuración adicional.

Paso a paso: crear una definición y completarla

En el administrador de Shopify (sin código)

1. Ve a Configuración > Datos personalizados.
2. Elige el tipo de recurso (Productos, Clientes, Pedidos, etc.).
3. Haz clic en Agregar definición. Nómbrala, elige un tipo de contenido y guarda.
4. A partir de la Edición Spring '26 de Shopify, también puedes crear metafields directamente desde páginas de clientes, pedidos y colecciones sin navegar primero a Configuración.
5. Abre cualquier producto (u otro recurso) y desplázate a la sección Metafields para completar valores.

Spring '26 también introdujo la capacidad de fijar hasta 50 metafields en secciones de producto, cliente y pedido para que tu equipo pueda ver y editar los campos más importantes sin hacer clic en una página separada.

A través de la API GraphQL Admin

Para operaciones masivas o canalizaciones automatizadas, usa metafieldDefinitionCreate (para crear el esquema) seguido de metafieldsSet (para escribir valores). La mutación metafieldsSet permite un máximo de 25 metafields por llamada, con un tamaño de carga máximo total de solicitud de 10 MB, y la operación es atómica: ningún cambio persiste si ocurre un error.

Una mutación de definición mínima se ve así:

mutation CreateMetafieldDefinition($definition: MetafieldDefinitionInput!) {
  metafieldDefinitionCreate(definition: $definition) {
    createdDefinition {
      id
      namespace
    }
    userErrors {
      field
      message
    }
  }
}

Con variables:

{
  "definition": {
    "name": "Material",
    "namespace": "custom",
    "key": "material",
    "type": "list.single_line_text_field",
    "ownerType": "PRODUCT",
    "useAsCollectionCondition": true
  }
}

Establecer useAsCollectionCondition: true significa que puedes usar inmediatamente este campo para potenciar reglas de colección inteligente, sin paso adicional requerido.

Para actualizaciones de catálogo masivas, herramientas como Matrixify te permiten importar valores de metafields desde un CSV sin escribir ningún código de API.

Mostrar metafields en tu tienda

Aquí es donde la mayoría de los comerciantes se quedan atascados. Crear la definición no hace que el campo aparezca en tu tienda. Necesitas conectarlo.

Opción 1: Fuentes dinámicas en el editor de temas (sin código)

Si estás en un tema compatible con Online Store 2.0 (Dawn, Horizon, o cualquier tema de plantilla JSON), abre el editor de temas, agrega o haz clic en una sección o bloque que admita fuentes dinámicas, y haz clic en el icono de conectar fuente dinámica. Puedes agregar hasta 20 metafields a una sola plantilla de esta manera.

Opción 2: Liquid (control total)

La sintaxis de Liquid es:

{{ product.metafields.namespace.key }}

Para un metafield de texto enriquecido, usa el filtro metafield_tag para renderizar correctamente el formato HTML:

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

Para una referencia de archivo de imagen:

{{ product.metafields.custom.hero_image.value | image_url: width: 800 | image_tag }}

Una trampa importante: si tu clave de metafield es size, first o last, usa notación de corchetes en lugar de notación de puntos: product.metafields.namespace["size"]. Estas palabras también son filtros incorporados de Liquid, y la notación de puntos aplicará el filtro en lugar de obtener el metafield cuando la clave falta.

Para los cinco casos de uso de página de producto de mayor impacto (pestañas de contenido personalizado, insignias de producto, tablas de especificaciones, PDFs descargables y listas de productos relacionados), cada uno necesita su propia definición y un bloque Liquid coincidente en el archivo sections/main-product.liquid de tu tema.

Qué cambió en 2026: las actualizaciones que importan

Spring '26 (anunciado a mediados de 2026):

• Los metafields del carrito se transfieren a los pedidos. Habilita cartToOrderCopyable en una definición de metafield de pedido y cualquier valor de metafield del carrito desde el checkout se copia automáticamente al pedido resultante. Esta es una oportunidad importante para la lógica posterior a la compra en Shopify Flow.
• Crea metafields sin salir de la página de recurso. Ya no necesitas navegar a Configuración > Datos personalizados para agregar una nueva definición; puedes hacerlo en línea desde cualquier registro de cliente, pedido o colección.
• Fija hasta 50 metafields en páginas de administración de producto, cliente y pedido.
• Filtrado con sintaxis de puntos en ShopifyQL. Los metafields ahora son compatibles como dimensiones y filtros en ShopifyQL con sintaxis de puntos, disponibles a través de la API de Analytics y el editor en línea. Esto significa que puedes segmentar tus informes de análisis por cualquier campo personalizado que hayas definido.
• API GraphQL más simple. La edición Spring '26 incluyó una interfaz de lectura/escritura simplificada para metafields y metaobjects, reduciendo el código repetitivo en aplicaciones.
• Los metafields de usuario de tienda son legibles durante el checkout a través de Shopify Functions, permitiéndote crear personalizaciones de checkout específicas del comprador contra datos de clientes almacenados.

API GraphQL Admin 2026-07 (candidato a lanzamiento a partir de julio de 2026):

• Metafields en transferencias de inventario. Ahora puedes definir y establecer metafields directamente en transferencias de inventario para almacenar números de lote, códigos de proveedores, detalles de envío o IDs de referencia de ERP sin una llamada separada a metafieldsSet.

Winter '26:

• Los metafields y metaobjects se renderizan más rápido en tiendas, admiten filtrado de consultas más enriquecido y permiten límites de entrada más altos que versiones anteriores de API.

Octubre de 2025 (API 2025-10):

• Se agregaron tipos article_reference y list.article_reference, permitiendo a los comerciantes crear vínculos formales de producto a artículo para flujos de SEO dirigido por contenido y comercio editorial.

Metafields vs. metaobjects: cuándo usar cuál

Un metafield almacena una única pieza de datos en un recurso existente. Un metaobject es una entrada de contenido independiente y reutilizable con su propio esquema multidimensional y su propia interfaz de administración. Usa metafields cuando los datos pertenecen solo a un producto específico (o pedido, o cliente). Usa metaobjects cuando el contenido se reutiliza en múltiples productos, como una guía de tallas compartida, una historia de marca o un perfil de proveedor.

Conectas los dos con un metafield metaobject_reference: el campo en el producto apunta a la entrada del metaobject, y actualizar la entrada actualiza automáticamente cada producto que la referencia.

Metafields y la capa de compra impulsada por IA

Este es el ángulo que la mayoría de los comerciantes se pierden en 2026. La "Edición Everywhere" de Summer '26 de Shopify hizo que el Protocolo de Comercio Universal (UCP) estuviera activo por defecto en cada tienda, permitiendo que agentes de compra impulsados por IA lean tu catálogo. Los datos estructurados dentro de tus metafields (especificaciones, ingredientes, certificaciones, materiales) es exactamente lo que los agentes de IA y los analizadores de resultados enriquecidos de Google consumen al decidir si mostrar tu producto.

Los metafields de categoría merecen especial atención aquí. Estos son atributos de producto que se asignan a una categoría de producto específica y ayudan a que los productos sean más detectables en tu sitio, en mercados y en motores de búsqueda. Cuando asignas la categoría de producto correcta en Shopify, obtienes entradas de metafield de categoría predeterminadas completadas previamente (por ejemplo, una categoría de Camisetas te da campos de tamaño, cuello, largo de manga, tela, género y color). Complétalos consistentemente y estarás alimentando datos estructurados a cada canal posterior simultáneamente.

Si has desglosado descripciones de productos en metafields separados para legibilidad, ten en cuenta que actualmente no puedes mapear más de un campo de Shopify a un único campo de descripción de Catálogo de Shopify. La solución alternativa es crear un metafield combinado que concatene tu descripción y datos clave de metafield, luego mapear ese único campo al catálogo.

Gobernanza: la parte que la mayoría de los equipos saltan

Los metafields son fáciles de crear y muy fáciles de dejar expandirse. Algunas reglas que evitan limpiezas costosas después:

• Documenta tu esquema. Mantén una hoja de referencia (una hoja de cálculo simple funciona) que registre cada espacio de nombres, clave, tipo, recurso propietario y qué aplicación o equipo es propietario de la definición.
• Usa definiciones estándar siempre que exista una. Son interoperables, validadas automáticamente e inmunes a colisiones de nombres.
• Nunca cambies un tipo después de tener datos en vivo. Migrar de date_time a money, por ejemplo, hace que todos los valores existentes sean no válidos. Planifica tipos correctamente desde el principio.
• Disciplina de espacio de nombres. Usa espacios de nombres distintos por aplicación o equipo (logistics, marketing, compliance) para que puedas auditar y limpiar por espacio de nombres sin afectar campos no relacionados.
• Prueba las escrituras como operaciones atómicas. La mutación metafieldsSet es atómica: o bien todos los 25 valores en una sola llamada tienen éxito, o ninguno. Estructura tus importaciones masivas alrededor de esta garantía.

Si necesitas ayuda para diseñar un esquema de metafield para un catálogo complejo o integrar metafields en una tienda personalizada, consulta la página de servicios de desarrollador de Shopify o el trabajo de desarrollador de temas de Shopify que hago con comerciantes.

Referencia rápida: cheat sheet de sintaxis Liquid

Los metafields son una de esas características donde pasar dos horas aprendiendo los fundamentos te ahorra semanas de soluciones alternativas después. Define tu esquema cuidadosamente, usa definiciones estándar donde existan, y conecta tus campos tanto a tu tienda como a tu capa de análisis. Las actualizaciones de 2026, especialmente la copia de carrito a pedido y el filtrado de ShopifyQL, significa que tus datos de metafield son más accionables que nunca.