# Cómo llevar un metafield de Shopify a la ficha y al JSON-LD > Cómo llevar un metafield de Shopify hasta la ficha publicada y su JSON-LD: definición, plantilla, fuente dinámica o Liquid, app embed y el HTML que lo prueba. URL: https://clione.ai/es/guias/metafield-a-pagina-publicada/ Lang: es Rellenas el material de una camiseta en un [metafield](/es/glosario/metafields/), guardas, abres la ficha y no está. O está en la ficha y no en el [JSON-LD](/es/glosario/json-ld/). Las dos cosas son normales en Shopify, porque **un dato guardado y un dato publicado viven en sitios distintos**: el primero en el panel, el segundo en el HTML que envía tu tienda. Esta guía sigue un valor de un metafield de producto desde su definición hasta el código fuente de la [ficha de producto](/es/glosario/ficha-de-producto/), con las reglas tal como las escribe Shopify, y en cada paso te dice cómo comprobar que ha pasado. ## Por dónde pasa un dato, y dónde se pierde El valor de un metafield de producto recorre cuatro tramos antes de que lo lea una persona o un [rastreador](/es/glosario/rastreador/): | Tramo | Qué tiene que pasar | Dónde se suele perder | Dónde se comprueba | | ------------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------- | | 1. Guardado | El producto tiene valor en un metafield con su definición | El producto está vacío, o el dato está en otro espacio de nombres | El producto, en el panel | | 2. En la plantilla | Una plantilla del tema publicado lo lee | Conectado en otra plantilla, en otro tema o en ninguno | El editor de temas o el código del tema | | 3. En el HTML | El valor sale escrito en la respuesta del servidor | Lo pinta una aplicación con su [app embed](/es/glosario/app-embed-shopify/) apagado, o JavaScript | El código fuente de la ficha | | 4. En el JSON-LD | El valor está dentro del marcado de producto | El marcado del tema no lo incluye | El bloque `application/ld+json` | Los tres primeros deciden si el dato se ve; el cuarto, si va dentro de los [datos estructurados](/es/glosario/datos-estructurados/). Son independientes: un dato puede verse sin estar en el marcado, y estar en el marcado sin verse, que es justo lo que Google pide evitar: no marques contenido que los lectores de la página no ven.[^google-sd-policies] ## Paso 1: comprueba la definición y el valor Un metafield tiene un identificador, que es el espacio de nombres más la clave (`custom.material`, por ejemplo), un valor y un tipo, que dice qué clase de dato es y cómo se interpreta. Antes del metafield se crea su definición, que es la que da la validación, el editor en el panel y el control de acceso. Shopify ofrece además definiciones estándar para casos comunes, como los ingredientes o las instrucciones de cuidado.[^shopify-metafields-dev] Abre la definición en los ajustes de datos personalizados del panel y **apunta tres cosas exactas: el espacio de nombres, la clave y el tipo**. Las vas a necesitar en los pasos 3 y 6. Después abre el producto y mira que ese metafield tiene valor: un producto sin valor no imprime nada, por bien conectado que esté. El espacio de nombres también dice de quién es el dato. Los que crea el comercio usan espacios no reservados, como `custom`; los de una aplicación van en su espacio reservado, `$app`, y los de Shopify suelen empezar por `shopify--`.[^shopify-metafields-dev] Si el valor lo escribió una aplicación en su espacio, mira primero si es ella quien lo publica: eso es el paso 4. Un ajuste que no tienes que tocar: el acceso de la definición a la Storefront API. Shopify dice que ese permiso es para los escaparates [_headless_](/es/glosario/headless-commerce/) y personalizados, y que **no afecta a las plantillas [Liquid](/es/glosario/liquid/): desde Liquid, los metafields son siempre accesibles**.[^shopify-metafields-dev] Ábrelo solo si tu escaparate es _headless_. ## Paso 2: averigua qué plantilla y qué tema pintan la ficha Cuando editas una plantilla, el cambio llega a todas las páginas que usan esa plantilla, y solo a ellas.[^shopify-help-templates] Un producto puede tener asignada una plantilla alternativa en lugar de la de producto por defecto: se elige en el propio producto, en el desplegable de plantilla del tema (_Theme template_ en el panel en inglés).[^shopify-help-templates] Esas plantillas se guardan con el nombre `product..json`, y puedes ver cualquier producto con una de ellas añadiendo `?view=` a su URL.[^shopify-alternate-templates] Si tocas el código, el objeto `template` de Liquid devuelve el sufijo de la plantilla que se está usando, o `nil` si es la de por defecto.[^liquid-template] Mira también qué tema estás editando. Las plantillas JSON son archivos del tema que guardan qué secciones se pintan y con qué ajustes,[^shopify-json-templates] así que **una conexión hecha en una copia del tema no está en el tema publicado** hasta que publiques esa copia. Antes de seguir, ten claras dos respuestas: qué plantilla usa la ficha que quieres arreglar y si el tema que tienes abierto es el publicado. ## Paso 3: conecta el metafield en la plantilla Hay dos caminos, y el tipo de tu tema decide cuál tienes. **Con una fuente dinámica, desde el editor de temas.** Una fuente dinámica conecta un ajuste de una sección o de un bloque con un dato de la tienda, como un atributo del producto o el valor de un metafield.[^shopify-dynamic-sources] Hace falta un tema que admita plantillas JSON.[^shopify-help-sections] Los temas Online Store 2.0 las tienen; los antiguos, que Shopify llama _vintage_, no.[^shopify-theme-versions] Para saber cuál tienes, Shopify propone abrir el editor del tema, ir a la plantilla de producto por defecto y mirar si debajo de la lista de secciones aparece el botón para añadir una sección: si aparece, el tema admite secciones en todas las páginas.[^shopify-theme-versions] Los pasos, según Shopify: abre el editor del tema, elige la plantilla donde está la sección o el bloque, pulsa el botón de fuente dinámica del ajuste que quieres rellenar, elige el metafield y guarda.[^shopify-help-sections] Su ejemplo es una tienda de velas que añade un bloque de texto a la sección principal de la plantilla de producto y lo conecta al metafield del tiempo de combustión. Cuando el icono de conexión muestra un **+**, puedes añadir hasta 20 metafields en una misma plantilla, de uno en uno.[^shopify-help-display] No todos los metafields encajan en todos los ajustes. Esta es la compatibilidad que publica Shopify, resumida:[^shopify-dynamic-sources] | Ajuste del bloque | Tipos de metafield que acepta | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Texto (`text`) | Texto de una línea y su lista, números enteros y decimales, fecha, fecha y hora, peso, volumen, dimensión, valoración y dinero | | Texto enriquecido (`richtext`) | Lo mismo, más texto de varias líneas, texto enriquecido y enlace | | Imagen (`image_picker`) | Referencia a un archivo | | Color (`color`) | Color | | URL (`url`) | URL | | Producto y lista de productos | Referencia a un producto y lista de referencias a productos | | Metaobjeto y lista de metaobjetos | Referencia a un [metaobjeto](/es/glosario/metaobjeto-shopify/) y su lista, de la misma definición que pide el ajuste | Dos consecuencias prácticas. **Un texto de varias líneas no entra en un ajuste de texto simple**: necesita uno de texto enriquecido (`richtext`). Y lo que no está en la tabla, como un booleano o un JSON, no se conecta desde el editor: para los tipos que el editor no admite, Shopify remite a editar el código del tema.[^shopify-dynamic-sources][^shopify-help-sections] **Con Liquid, en el código del tema.** Es el camino de los temas _vintage_, de los tipos sin ajuste compatible y de quien quiere controlar el HTML exacto. Shopify avisa de que edites el código del tema solo si tienes experiencia programando.[^shopify-help-display] En Liquid, un metafield se lee con `product.metafields.namespace.key`, y su propiedad `value` devuelve el dato con el formato de su tipo: una cadena para el texto, un número para los números, un objeto de medida para el peso.[^liquid-metafield] Un ejemplo ficticio, para la sección de producto: ```liquid {% if product.metafields.custom.material %}

Material: {{ product.metafields.custom.material.value }}

{% endif %} ``` Tres detalles de la referencia de Liquid que ahorran una tarde. Si la clave de tu metafield es `size`, `first` o `last`, léela con corchetes (`product.metafields.custom["size"]`): con punto, si el metafield no existe, Liquid aplica el filtro del mismo nombre y `size` devuelve cuántos metafields hay en vez de nada. Los tipos antiguos `integer`, `json_string` y `string` no tienen estas propiedades ni admiten los filtros de metafields.[^liquid-metafield] Y si no quieres escribir el HTML a mano, el filtro `metafield_tag` genera un elemento distinto según el tipo, como un `