Abra una página de producto activa en su tienda, vea el código fuente de la página y busque application/ld+json antes de agregar cualquier código. Muchos temas de Shopify ya publican datos estructurados, así que lo primero es revisar qué hay y si es exacto.

A partir de ahí, el camino es corto. Duplique su tema, decida entre una pequeña edición de Liquid o una app probada, mantenga un solo grafo Product exacto por página de producto y valídelo con la Prueba de resultados enriquecidos de Google (Rich Results Test) y el Schema Markup Validator (validador de marcado schema). Bing y Yandex ofrecen sus propios validadores cuando esos motores son importantes para su tienda.

Puntos clave

  1. Revise antes de agregarVea el código fuente de una página de producto activa y busque application/ld+json. Su tema o una app ya podrían publicar un grafo Product.
  2. Duplique el temaShopify recomienda duplicar un tema antes de hacer cambios en el código, porque las actualizaciones pueden eliminar personalizaciones que no encajen con la nueva versión.
  3. Un grafo por productoMantenga un grafo Product exacto por página de producto, con los datos de precio, moneda, disponibilidad, imagen, URL y SKU que ven los visitantes.
  4. Variantes y reseñasUse ProductGroup cuando las variantes tengan sus propias URL, y agregue reseñas o calificaciones solo cuando sean auténticas, visibles y sobre ese producto.
  5. Valide y monitoreeUse la Prueba de resultados enriquecidos y el Schema Markup Validator, y después revise Search Console. El marcado válido no garantiza resultados enriquecidos, posicionamiento ni citas de IA.

Revise lo que su tienda ya publica

Es posible que su tienda ya describa sus productos a los motores de búsqueda, así que revise antes de escribir nada. Los temas de Shopify se construyen con plantillas y secciones, y una sección puede imprimir un script JSON-LD en la página. Si la suya lo hace depende del tema, de su versión, de los datos de sus productos y de las apps que tenga instaladas.

Un hombre con camisa a cuadros lee una laptop en una mesa de empaque de un pequeño taller de jabón, con barras de jabón envueltas a su lado
Figura 1. Ver el código fuente de una página de producto activa es el primer paso, antes de agregar cualquier código.

Haga esto en la tienda activa y no en la vista previa del editor de temas, porque la vista previa puede ocultar lo que reciben los visitantes y los rastreadores:

  1. Abra una página de producto en su navegador.
  2. Vea el código fuente de la página y busque application/ld+json.
  3. Cuente los bloques y lea el @type de cada uno. Busque Product, ProductGroup, Organization y WebSite.
  4. Compare el precio, la moneda, la disponibilidad, la imagen, la URL y el SKU del marcado con lo que muestra la página.

Las apps también pueden insertar marcado, así que revise la página renderizada en las herramientas para desarrolladores de su navegador, además del código fuente sin procesar. Si encuentra dos bloques Product, o un bloque cuyo precio no coincide con el precio visible, anótelo ahora. La sección sobre duplicados que aparece más abajo explica cómo resolverlo.

Lo que publican Dawn y Online Store 2.0

JSON-LD es un formato legible por máquinas para describir información visible en una página. Schema.org aporta el vocabulario, como Product y Offer, mientras que Google, Bing, Yandex y otros sistemas deciden qué propiedades usan (JSON-LD 1.1, W3C).

Los temas de Online Store 2.0 usan plantillas JSON como envoltorios alrededor de las secciones de Liquid, y los archivos Liquid generan el HTML y pueden contener scripts JSON-LD, según la documentación de arquitectura de temas de Shopify. El tema de referencia Dawn de Shopify muestra cómo se ve eso. Su sección de encabezado publica un objeto Organization con el nombre de la tienda, el logotipo, los perfiles sociales y la URL, y su página de inicio publica un objeto WebSite con un SearchAction. Su sección principal de producto contiene el JSON-LD del producto.

Entonces, ¿Shopify agrega marcado schema automáticamente? Dawn sí lo hace, pero el repositorio de Dawn cambia con el tiempo, y los temas personalizados o antiguos pueden ser distintos. El tema que tiene instalado es la referencia para su tienda, por eso la revisión va primero.

El SearchAction de ese objeto WebSite merece una nota. Google retiró la función de cuadro de búsqueda de enlaces de sitio, o sitelinks search box (blog de Google Search Central, junio de 2025), así que agregar SearchAction solo para lograr esa presentación ya no es una razón. El vocabulario en sí sigue siendo Schema.org válido, y otros consumidores aún pueden leerlo, así que no hay necesidad de apresurarse a eliminar lo que su tema ya publica.

Elija entre Liquid en el tema o una app

Editar el Liquid del tema conviene a una tienda con un desarrollador o a un propietario con buena base técnica. Le da el control máximo, sirve para una corrección precisa del marcado existente y resuelve la lógica personalizada de variantes, marca u oferta sin depender de otra app. El costo es el mantenimiento: Shopify advierte que las actualizaciones de tema pueden eliminar personalizaciones que sean incompatibles con la nueva versión, así que anote cada cambio que haga.

Una app conviene a una tienda que no quiere mantener Liquid. Busque una app que documente exactamente qué marcado agrega, que actualice sus datos a partir de los productos y variantes de Shopify, y que pueda desactivar el marcado superpuesto o reconocer lo que el tema ya publica. Las apps también pueden duplicar el marcado, entrar en conflicto entre sí, depender de una suscripción o dejar datos desactualizados, así que pruebe cualquier app primero en un tema duplicado.

Una tarjeta de página que se divide en una ruta de edición manual y otra de plug-in, que se unen en una tarjeta de producto brillante con una marca de verificación
Figura 2. Las ediciones de Liquid y las apps son dos rutas hacia la misma meta: un grafo de producto exacto.

Una sección de Liquid personalizado (Custom Liquid) queda entre ambas opciones. Sirve para una adición controlada, pero es fácil colocar el marcado en una plantilla equivocada o repetir un grafo que ya existe. Elija la ruta que elija, Shopify recomienda duplicar el tema antes de hacer cambios en el código, y el duplicado es donde se hacen las pruebas.

Si también tiene un sitio en WordPress, la guía de datos estructurados en WordPress sigue la misma rutina de revisar primero para plugins y temas.

Agregue o corrija un grafo Product en Liquid

Edite solo cuando lo que el sitio publica actualmente falte o sea inexacto. En Dawn, el JSON-LD del producto está en sections/main-product.liquid, aunque otros temas usan un snippet (fragmento de código) o una sección que se renderiza en las plantillas de producto. El archivo exacto varía según el tema. Si el bloque de su tema es exacto, déjelo como está; si le falta algo, agregue la propiedad faltante a ese mismo bloque en lugar de crear un segundo.

Google indica que el marcado Product puede hacer que una página sea apta para fragmentos de producto (product snippets) o fichas de comerciante (merchant listings), y que la elegibilidad no garantiza que se muestren (documentación de Google actualizada en septiembre de 2026). Las fichas de comerciante necesitan un nombre, una imagen y un Offer de compra con precio y moneda. Los fragmentos de producto necesitan un nombre y al menos uno de offers, review o aggregateRating.

Este producto ficticio muestra un grafo completo para una página de producto:

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/products/blue-harbor-lantern#product",
  "url": "https://example.com/products/blue-harbor-lantern",
  "name": "Blue Harbor Lantern",
  "image": [
    "https://example.com/images/blue-harbor-lantern.jpg"
  ],
  "description": "Una linterna recargable ficticia para uso en interiores y exteriores.",
  "sku": "EX-LANTERN-001",
  "brand": {
    "@type": "Brand",
    "name": "Example Workshop"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/blue-harbor-lantern",
    "priceCurrency": "USD",
    "price": 39.95,
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

Reemplace cada valor con datos que un visitante pueda ver en esa página de producto, y complételo con el valor correspondiente de sus datos de producto, como lo hace el bloque existente de su tema. En un archivo del tema, este JSON va dentro de un elemento script con type="application/ld+json". Mantenga el JSON estricto, sin comentarios ni comas finales.

Para crear el mismo grafo sin escribirlo a mano, use el generador de schema de producto y compare su resultado con el bloque de su tema. La guía de marcado schema de producto explica cada propiedad con más detalle.

Un objeto Organization para su tienda es una decisión aparte y opcional. Google no exige ningún requisito de resultado enriquecido de producto para él. Agréguelo solo cuando describa con exactitud la identidad comercial visible de su tienda, y en sameAs incluya únicamente perfiles oficiales.

Google exige algunas de estas propiedades para las fichas de comerciante, solo recomienda otras y algunas son opcionales. Schema.org permite un vocabulario más amplio que el que Google usa actualmente, así que una propiedad puede ser válida sin ser obligatoria para esta función de Google.

Propiedades del producto según su estado en las fichas de comerciante de Google

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadEstado en esta función de GoogleQué ingresar
name, image, offersObligatorioUn nombre de producto visible, una URL de imagen y un Offer de compra
price, priceCurrencyObligatorioEl precio que se muestra en la página y su código de moneda
Offer url, availability, itemConditionRecomendadoLa URL del producto, un valor de disponibilidad de Schema.org y la condición del artículo
brandRecomendado si se conoceEl nombre de la marca, como objeto Brand
description, skuOpcionalUna descripción breve y visible y el SKU que se muestra para el producto
aggregateRating, reviewSolo si es auténticaCalificaciones o reseñas auténticas, visibles y sobre este producto

Marque las variantes con ProductGroup

Una página de producto puede representar un producto con varias variantes, como colores o tallas. Google admite ProductGroup con hasVariant, variesBy y productGroupID para describir cómo se relacionan esas variantes (anuncio de Google sobre variantes de producto, febrero de 2024).

Este es el patrón cuando cada variante tiene su propia URL. Cada variante lleva su propio nombre, SKU, URL, imagen, precio, moneda y disponibilidad siempre que esos valores sean distintos:

json
{
  "@context": "https://schema.org",
  "@type": "ProductGroup",
  "@id": "https://example.com/products/blue-harbor-lantern#group",
  "name": "Blue Harbor Lantern",
  "description": "Una linterna recargable ficticia que se vende en dos colores.",
  "productGroupID": "EX-LANTERN",
  "variesBy": [
    "https://schema.org/color"
  ],
  "hasVariant": [
    {
      "@type": "Product",
      "@id": "https://example.com/products/blue-harbor-lantern?variant=blue#product",
      "isVariantOf": {
        "@id": "https://example.com/products/blue-harbor-lantern#group"
      },
      "url": "https://example.com/products/blue-harbor-lantern?variant=blue",
      "name": "Blue Harbor Lantern, Blue",
      "color": "Blue",
      "image": [
        "https://example.com/images/blue-harbor-lantern-blue.jpg"
      ],
      "sku": "EX-LANTERN-BLUE",
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/products/blue-harbor-lantern?variant=blue",
        "priceCurrency": "USD",
        "price": 39.95,
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/NewCondition"
      }
    },
    {
      "@type": "Product",
      "@id": "https://example.com/products/blue-harbor-lantern?variant=green#product",
      "isVariantOf": {
        "@id": "https://example.com/products/blue-harbor-lantern#group"
      },
      "url": "https://example.com/products/blue-harbor-lantern?variant=green",
      "name": "Blue Harbor Lantern, Green",
      "color": "Green",
      "image": [
        "https://example.com/images/blue-harbor-lantern-green.jpg"
      ],
      "sku": "EX-LANTERN-GREEN",
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/products/blue-harbor-lantern?variant=green",
        "priceCurrency": "USD",
        "price": 41.95,
        "availability": "https://schema.org/OutOfStock",
        "itemCondition": "https://schema.org/NewCondition"
      }
    }
  ]
}

Cambie el nombre del grupo y productGroupID para que coincidan con su producto, y después asigne a cada variante la URL, el SKU, la imagen y la oferta que realmente tiene. La variante verde de este ejemplo tiene un precio distinto y está agotada, y ese tipo de diferencia corresponde a la variante y no al grupo. Para la función de variantes de Google, ProductGroup necesita un nombre, productGroupID, variesBy y hasVariant, y el color de cada variante u otra propiedad que varíe necesita un valor.

Si las variantes tienen URL distintas, cada URL debe identificar con exactitud su propia variante. No describa todas las variantes como productos no relacionados, a menos que la página y la URL respalden esa lectura. La guía de schema de variantes de producto cubre con más detalle los casos de una sola página y de varias páginas.

Muestre reseñas y calificaciones solo cuando sean auténticas

Agregue Review o AggregateRating solo cuando la reseña o la calificación sea auténtica, esté visible en la página y trate sobre el producto que marcó. Nunca invente calificaciones, cantidades de reseñas ni nombres de quienes reseñan. Una reseña de cliente en la página de producto de su propia tienda también es algo distinto de una reseña editorial de producto, y Google indica que su presentación de pros y contras se aplica a las páginas de reseñas editoriales, no a las páginas comunes de productos de comerciante ni a las reseñas de clientes.

Las apps de reseñas suelen agregar tanto el widget visible de reseñas como su JSON-LD. Antes de escribir un grafo de reseñas a mano, revise la página renderizada para ver si la app ya publica uno. Si lo hace, compruebe que describa este producto y que sus números coincidan con lo que ven los visitantes. La guía de marcado schema de reseñas explica los contextos permitidos.

Elimine el marcado duplicado

Dos o más grafos que describen el mismo producto pueden dejar una página con datos contradictorios, por ejemplo dos precios o dos valores de disponibilidad. Los duplicados suelen surgir en una de estas situaciones:

  • Dawn ya publica un grafo de producto y una app agrega otro.
  • Un snippet del tema se incluye tanto en todo el sitio como en la plantilla de producto.
  • Una app de reseñas agrega un segundo objeto Product con un precio o una disponibilidad distintos.
  • Se agrega un grafo de producto a las tarjetas de colección en lugar de a las páginas de producto.
  • Dos versiones del tema permanecen activas en la vista previa y se confunden durante las pruebas.

La solución preferida es mantener un único grafo de producto principal, incorporarle las propiedades compatibles que falten y eliminar o desactivar el resultado superpuesto. Para decidir cuál es el principal, pregúntese cuál puede mantener exacto con el tiempo. No elimine el marcado existente hasta haber validado su reemplazo, para que una página de producto nunca quede sin ningún grafo.

Cuando Search Console o un validador informe campos faltantes, la guía para corregir advertencias de campos faltantes en datos estructurados repasa las causas más comunes.

Valide y monitoree

Use varias capas, porque cada una responde a una pregunta distinta. Un analizador le indica si el JSON está bien formado, las revisiones del vocabulario de Schema.org indican si los tipos y las propiedades son válidos, y una prueba de función de Google indica si la página puede ser apta para esa función. Ninguna de ellas le dice si el resultado está indexado o si se muestra.

Comience con su página activa y recorra estas comprobaciones:

  1. Inspeccione el código fuente y el HTML renderizado para buscar application/ld+json.
  2. Confirme que el JSON es sintácticamente correcto, sin comentarios ni comas finales.
  3. Pruebe la URL con la Prueba de resultados enriquecidos de Google (Rich Results Test) para comprobar la elegibilidad en la función de Google.
  4. Páselo por el Schema Markup Validator para revisiones generales del vocabulario de Schema.org, o pegue el código en el validador de Schema Nova.
  5. Después de que la página se indexe, revise los informes Merchant listings (fichas de comerciante) y Product snippets (fragmentos de producto) en Google Search Console, donde Google indica que pueden aparecer errores y advertencias.
  6. Vuelva a revisar tras las actualizaciones del tema, los cambios en la app de reseñas, en el feed de productos o en los precios.

Bing ofrece un Markup Validator en Bing Webmaster Tools y dice que admite JSON-LD y Schema.org; vea también el anuncio de JSON-LD en el Bing Webmaster Blog. El Yandex Structured Data Validator reconoce Schema.org, JSON-LD, Microdata, RDFa, Open Graph y microformatos. La guía del reemplazo de la herramienta de prueba de datos estructurados explica cómo se reparten el trabajo estas herramientas.

Pasos de configuración (la ubicación del archivo varía según el tema)

  1. Revisar el marcado existenteVea el código fuente de una página de producto activa y busque application/ld+json.
  2. Duplicar el temaHaga los cambios en la copia, no en el tema activo.
  3. Elegir Liquid o una appElija la ruta que pueda mantener y confirme qué agrega una app.
  4. Agregar un grafo principalCorrija o agregue un grafo Product con datos visibles, y elimine los superpuestos.
  5. Probar sintaxis y elegibilidadEjecute el Schema Markup Validator y la Prueba de resultados enriquecidos de Google.
  6. Publicar y monitorearPublique y luego revise los informes de Search Console después de la indexación.

Haga legible el marcado de producto para Bing y la búsqueda con IA

Bing indica que las anotaciones pueden complementar o validar sus datos y pueden mejorar el aspecto de los resultados, y los resultados de DuckDuckGo pueden incluir datos de Bing, así que el mismo JSON-LD Product exacto les sirve a ambos. Yandex indica que el marcado Schema.org puede respaldar fragmentos de producto y de precio (guía de Yandex sobre Schema.org). Google indica que AI Overviews y AI Mode no necesitan marcado especial para IA, y que los datos estructurados deben coincidir con el contenido visible (documentación de funciones de IA de Google, actualizada en diciembre de 2025).

OpenAI recomienda permitir OAI-SearchBot en robots.txt si quiere que su sitio aparezca en la búsqueda de ChatGPT (documentación de rastreadores de OpenAI), y Perplexity recomienda revisar robots.txt y las reglas de firewall para PerplexityBot (guía de rastreadores de Perplexity). Mantenga visibles los datos del producto y las URL canónicas coherentes. Vea si la IA usa el marcado schema.

Preguntas frecuentes

¿Shopify agrega marcado schema automáticamente?

Muchos temas sí lo hacen. Dawn publica datos Organization y WebSite en su encabezado y el JSON-LD del producto en su sección de producto, pero el resultado depende de la versión de su tema, de los datos de sus productos y de las apps. Revise una página de producto activa para ver el resultado de su propia tienda.

¿Debo agregar una app de schema si mi tema ya tiene JSON-LD?

Solo si la app cubre algo que el resultado de su tema no incluye y puede evitar un segundo grafo Product. Pídale a la app que identifique o desactive el resultado superpuesto, y pruébela en un tema duplicado antes de publicarla.

¿Debo usar Product o ProductGroup para las variantes?

Use un Product simple para un solo producto. Use ProductGroup con hasVariant, variesBy y productGroupID cuando un producto tenga variantes, como color o talla, y dé a cada variante que tenga su propia URL datos exactos para esa URL.

¿Una app de reseñas puede agregar schema de reseñas?

Sí, y muchas apps publican tanto las reseñas visibles como el marcado. Revise primero la página renderizada y conserve el marcado solo si las reseñas son auténticas, visibles y tratan sobre ese producto.

¿El schema válido garantiza resultados enriquecidos?

No. Google indica que la elegibilidad no garantiza que se muestre, y Bing dice lo mismo sobre los fragmentos enriquecidos. El marcado válido tampoco garantiza posicionamiento, tráfico ni citas en las respuestas de IA.

Verificación rápida

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

Un bloque JSON-LD se procesa correctamente, pero describe un producto que no es visible en la página. ¿Es seguro publicarlo?

Pregunta 2 de 3

Una app de reseñas y su tema publican cada uno un grafo Product. ¿Qué debe hacer?

Pregunta 3 de 3

La Prueba de resultados enriquecidos muestra un producto como apto. ¿Qué significa?

Glosario

Seleccione un término para ver su definición.

JSON-LD. Formato basado en JSON para datos vinculados y legibles por máquinas.