Saltar al contenido

Datos estructurados de producto: precio y stock en Google

Guía/ 13 min de lectura

Qué necesita Google en el JSON-LD de Product, un ejemplo completo, qué imprime ya un tema de Shopify y cómo validarlo sin adivinar.

  • SEO
  • Shopify
  • Liquid
En este artículo (8)
  1. Qué son los datos estructurados
  2. Propiedades obligatorias y recomendadas de Product
  3. Ejemplo JSON-LD completo
  4. Cómo lo maneja un tema de Shopify
  5. Validar y corregir errores (y quién decide al final)
  6. Errores comunes
  7. Preguntas frecuentes
  8. Checklist

Los datos estructurados de producto son un bloque JSON-LD en la página que le dice a Google, sin ambigüedad, qué vendes: nombre, imagen, precio, moneda, stock y reseñas. Con ellos tu ficha puede aparecer en la búsqueda con precio, disponibilidad y estrellas. Te hacen elegible; Google decide si lo muestra.

En esta guía vas a ver qué propiedades pide Google, un JSON-LD completo y comprobado, qué imprime ya un tema de Shopify y cómo validarlo antes y después de publicar. Si todavía no revisaste lo básico (indexación, canonical, sitemap), empieza por los fundamentos de SEO técnico para tiendas Shopify.

Qué son los datos estructurados

Una página de producto ya muestra el precio y el stock, pero para un buscador eso es texto suelto: «349» puede ser un precio, un código o un número de reseñas. Los datos estructurados lo dicen de forma explícita con el vocabulario de schema.org: esto es un Product, este es su name, esta su offers con price y priceCurrency. Google admite tres formatos y recomienda JSON-LD, según sus directrices generales de datos estructurados: un <script type="application/ld+json"> aparte del HTML visible, fácil de generar desde una plantilla.

Para productos, la documentación de Product distingue dos experiencias:

  • Fragmentos de producto: para páginas donde no se puede comprar, como una reseña editorial. Destacan la información de reseñas, incluidos pros y contras.
  • Fichas de comerciante: para páginas donde el cliente te compra a ti. Admiten más detalle: tallas, envío y devoluciones.

Una tienda quiere lo segundo. Y hay un atajo: según Google, si tu página tiene las propiedades obligatorias de las fichas de comerciante, también puede ser elegible para los fragmentos de producto. Si además tienes un feed en Merchant Center, Google dice que usar las dos cosas maximiza la elegibilidad y le ayuda a verificar tus datos.

el mismo resultado de búsqueda (ilustrativo)sin datos estructuradosexample.com › productsTaza de cerámica 350 mlsolo título y descripcióncon datos estructuradosexample.com › productsTaza de cerámica 350 ml4,6/5 · 38 reseñas$349.00 MXN · En stockEnvío $99 · Devolución 30 díasel marcado te hace elegible; google decideprecio, stock y reseñas tienen que verse también en la página

Desliza la figura para verla completa

Una regla de las directrices vale para todo lo que sigue: no marques contenido que el visitante no ve. Si el JSON-LD dice 4,6 estrellas, las reseñas tienen que estar en la página; si dice «en stock», el botón de compra tiene que estar activo.

Propiedades obligatorias y recomendadas de Product

Esta tabla resume la documentación de fichas de comerciante tal como estaba el 30 de octubre de 2026:

PropiedadNivelQué poner
nameObligatoriaEl nombre del producto, como aparece en la página.
imageObligatoriaUna o más URL rastreables. Google recomienda varias en alta resolución, en proporciones 16x9, 4x3 y 1x1.
offersObligatoriaUn Offer anidado. Tú tienes que ser el vendedor.
offers.priceObligatoriaEl precio actual, como número y mayor que cero.
offers.priceCurrencyObligatoriaCódigo ISO 4217 de tres letras: MXN, USD, EUR.
offers.availabilityRecomendadaUn solo valor, como https://schema.org/InStock u OutOfStock.
offers.itemConditionRecomendadaNewCondition, RefurbishedCondition o UsedCondition.
brand, sku, gtin, mpnRecomendadasIdentificadores del producto. Si tienes GTIN reales, inclúyelos.
aggregateRating, reviewRecomendadasSolo si las reseñas son de clientes y se ven en la página.
shippingDetails, hasMerchantReturnPolicyRecomendadasEnvío y devoluciones. Google prefiere una política global (ver más abajo).

Los fragmentos de producto piden menos: name y al menos una de review, aggregateRating u offers, según la documentación de fragmentos de producto. Y dos reglas que descartan páginas enteras: solo cuentan las páginas centradas en un producto (o en variantes de un mismo producto), no las colecciones; y para las fichas de comerciante, solo las páginas donde de verdad se puede comprar.

anatomía de un bloque JSON-LD de Product"@type": "Product"una página, un producto"name"obligatorio"image"obligatorioURL rastreable"brand", "sku"recomendadoidentifican el producto"aggregateRating"recomendadosolo con reseñas visibles"offers": Offerobligatoriofichas de comerciante"price"obligatorionúmero mayor que 0"priceCurrency"obligatorioISO 4217: MXN, USD"availability"recomendadoschema.org/InStock"shippingDetails"recomendadoo en Merchant Center"hasMerchantReturnPolicy"recomendadoo en Search Consolesin lo obligatorio no hay resultado enriquecidolo recomendado suma información; no es requisito para ser elegible

Desliza la figura para verla completa

Ejemplo JSON-LD completo

Este es un ejemplo ficticio e ilustrativo: la tienda, la marca, el precio y las reseñas no existen, y las URL usan el dominio reservado example.com. Lo parseamos con JSON.parse y un script local comprobó las reglas de la tabla anterior:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Taza de cerámica artesanal 350 ml",
  "description": "Taza de gres esmaltada a mano. Apta para lavavajillas y microondas.",
  "image": [
    "https://example.com/fotos/1x1/taza-azul.jpg",
    "https://example.com/fotos/4x3/taza-azul.jpg",
    "https://example.com/fotos/16x9/taza-azul.jpg"
  ],
  "sku": "TAZA-AZUL-350",
  "brand": { "@type": "Brand", "name": "Cerámica Ejemplo" },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.6,
    "reviewCount": 38
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/taza-azul-350",
    "price": 349.00,
    "priceCurrency": "MXN",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": { "@type": "MonetaryAmount", "value": 99, "currency": "MXN" },
      "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "MX" },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": { "@type": "QuantitativeValue", "minValue": 0, "maxValue": 1, "unitCode": "DAY" },
        "transitTime": { "@type": "QuantitativeValue", "minValue": 2, "maxValue": 5, "unitCode": "DAY" }
      }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "MX",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}
</script>

Bloque por bloque:

  1. <script type="application/ld+json">: el contenedor. El navegador no lo pinta; Google lo lee. Puede ir en el <head> o en el <body>.
  2. @context y @type: el vocabulario (schema.org) y el tipo de cosa que describes, un Product.
  3. name, description, image: el nombre igual que en el H1 de la página, una descripción real y tres fotos en las proporciones que Google recomienda. Las URL de imagen tienen que poder rastrearse e indexarse.
  4. sku y brand: identificadores. Con un GTIN real (código de barras) suma gtin13 o el que corresponda; no lo inventes.
  5. aggregateRating: la media (ratingValue) y cuántas reseñas (reviewCount). Sin bestRating, Google asume una escala de 5. Quita este bloque si las reseñas no se ven en la página.
  6. offers: el precio como número con punto decimal y sin símbolo, la moneda en ISO 4217, el estado del producto y la disponibilidad con la URL completa de schema.org.
  7. shippingDetails: costo de envío, país de destino, días de preparación (handlingTime) y de tránsito (transitTime), en DAY.
  8. hasMerchantReturnPolicy: país, tipo de política, 30 días para devolver, devolución por correo y sin costo. Con MerchantReturnFiniteReturnWindow, merchantReturnDays es obligatorio.

Sobre envío y devoluciones, Google recomienda declarar una política global en el marcado de Organization y usar las propiedades del Offer solo para productos que la cambian. También puedes configurarlas a nivel de cuenta en Merchant Center o en Search Console. Si las defines en varios sitios, el orden de prioridad que publica Google es: feed de producto en Merchant Center, Content API, configuración de Merchant Center o Search Console, marcado del producto y, al final, marcado de la organización.

Cómo lo maneja un tema de Shopify

Shopify tiene un filtro para esto. El filtro structured_data convierte un objeto product (o article) a schema.org: un Product si no tiene variantes y un ProductGroup si las tiene. Dawn, el tema de referencia de Shopify, lo imprime en sections/main-product.liquid así:

<script type="application/ld+json">
  {{ product | structured_data }}
</script>

En el ejemplo de la documentación, la salida trae name, description, image, brand (el proveedor), url y un offers con price, priceCurrency, availability y url. Cubre lo obligatorio. No trae envío ni devoluciones; para eso, lo más simple en Shopify es configurarlos en Merchant Center o en Search Console, que Google acepta a nivel de cuenta.

Antes de tocar nada, mira qué imprime ya tu tienda: abre una página de producto, ve al código fuente y busca application/ld+json. Es común encontrar dos bloques Product, uno del tema y otro de una app de reseñas. Si dicen cosas distintas (otro precio, otra moneda), le das a Google dos versiones de la verdad; quédate con uno.

Si tu tema no usa el filtro, o necesitas controlar cada propiedad, puedes construir el JSON-LD a mano con el filtro json, que pone las comillas y escapa lo que haga falta. Este snippet pasó shopify theme check en un tema mínimo local:

{% doc %}
  Prints Product JSON-LD for the selected or first available variant.
  @param {product} product - The product on the page
  @example
  {% render 'product-json-ld', product: product %}
{% enddoc %}
{%- assign variant = product.selected_or_first_available_variant -%}
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Product",
    "name": {{ product.title | json }},
    "description": {{ product.description | strip_html | strip | json }},
    {%- if product.featured_image %}
    "image": {{ product.featured_image | image_url: width: 1200 | prepend: 'https:' | json }},
    {%- endif %}
    {%- if variant.sku != blank %}
    "sku": {{ variant.sku | json }},
    {%- endif %}
    "brand": { "@type": "Brand", "name": {{ product.vendor | json }} },
    "offers": {
      "@type": "Offer",
      "url": {{ variant.url | prepend: request.origin | json }},
      "price": {{ variant.price | divided_by: 100.0 }},
      "priceCurrency": {{ cart.currency.iso_code | json }},
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/{% if variant.available %}InStock{% else %}OutOfStock{% endif %}"
    }
  }
</script>

Línea por línea:

  • {% doc %}: el encabezado LiquidDoc que Shopify pide en los snippets. Se usa con {% render 'product-json-ld', product: product %}, en lugar del bloque del filtro, no además.
  • assign variant: la variante elegida o la primera disponible, para que precio, SKU y stock sean los de lo que el cliente ve.
  • | json en cada texto: si el título trae comillas, como Taza "azul", el JSON sigue siendo válido. Escribir "{{ product.title }}" a mano lo rompe.
  • if product.featured_image e if variant.sku != blank: no imprimen una propiedad vacía. Cada bloque termina en coma y le sigue una propiedad fija, así que el JSON queda válido en los dos casos.
  • prepend: 'https:': image_url devuelve una URL que empieza con //; la completamos.
  • prepend: request.origin: variant.url es relativa; request.origin le pone el protocolo y el dominio de la tienda.
  • divided_by: 100.0: Liquid da los precios en centavos; dividir entre 100.0 da un decimal con punto. Shopify advierte que no uses money_without_currency para el price de schema.org: con un formato de moneda que usa coma decimal el valor queda inválido.
  • cart.currency.iso_code: la moneda en la que el cliente ve el precio, como código ISO.
  • availability: InStock u OutOfStock según la variante.

Lo validamos con shopify theme check y renderizamos su JSON con valores de prueba (con y sin SKU, con y sin imagen, con y sin stock) para confirmar que se parsea. No lo renderizamos en una tienda real: antes de publicarlo, pruébalo en un tema de desarrollo.

Validar y corregir errores (y quién decide al final)

El flujo que propone Google tiene dos herramientas y un informe:

  1. Prueba de resultados enriquecidos. En search.google.com/test/rich-results pegas una URL pública o un fragmento de código. Por defecto prueba como smartphone. La ayuda de la prueba separa los resultados en elementos válidos, válidos con advertencias e inválidos. Google pide corregir los errores críticos; las advertencias mejoran tus datos, pero no son necesarias para ser elegible. Para probar una URL, la página y sus recursos tienen que ser accesibles sin contraseña.
  2. Inspección de URLs. Después de publicar unas pocas páginas, en Search Console ves cómo las ve Google y si algo bloquea el rastreo: robots.txt, noindex o un inicio de sesión.
  3. Informes de Search Console. En la sección Shopping están «Fragmentos de productos» y «Fichas de comercios», con los elementos válidos e inválidos de todo el sitio. Cuando corriges un problema, el botón «Validar corrección» revisa primero una muestra de páginas; según la ayuda sobre la validación, suele tardar unas dos semanas y avisa cuando termina.
de tu tema al informe de Search Console1JSON-LDen el tema2Prueba deresultados enriquecidosURL o código3corrigeerrores primeroy vuelve a probar4publicaunas pocas páginas5Inspección de URLscómo la ve Google6Search Consoleinformes de ShoppingValidar correcciónGoogle decide si muestra el resultado enriquecidovalidar una corrección suele tardar unas dos semanaspasar la prueba no garantiza el resultadola prueba revisa la sintaxis; las políticas las revisa Google después

Desliza la figura para verla completa

Y lo más importante: pasar la prueba no garantiza nada. Las directrices lo dicen literal: Google no garantiza que tus datos estructurados aparezcan en los resultados. Te hacen elegible; Google decide cuándo y qué mostrar, y la documentación de Product aclara que las mejoras como reseñas, envío o devoluciones se muestran a criterio de cada experiencia. La prueba revisa la sintaxis, no las políticas: si el marcado describe algo que no está en la página, puede acabar en una acción manual, que quita la elegibilidad para resultados enriquecidos (según Google, no cambia cómo se posiciona la página en la búsqueda web).

Mensaje habitualCausa probableArreglo
Falta offers, review o aggregateRatingSolo hay name e imageAñade el Offer con precio y moneda
Valor de price no válidoPrecio con coma o símbolo: "349,00", "$349"Número con punto: 349.00
Falta priceCurrencyMoneda sin declarar o con símboloCódigo ISO 4217: MXN
Error de análisisComillas sin escapar en el nombre o una coma de másUsa | json en cada texto

Estos mensajes son ejemplos de lo que suele pasar, no el texto exacto de la herramienta, que cambia con el tiempo.

Errores comunes

  • Marcar reseñas que no se ven. Si el bloque dice 4,6 estrellas, las reseñas tienen que estar en la página y venir de clientes.
  • Dos bloques Product con datos distintos. El tema y una app imprimen cada uno el suyo, con otro precio o moneda. Quédate con uno.
  • Precio con formato de moneda. money_without_currency o un precio con coma decimal dejan un price inválido. Usa un número con punto.
  • Precio o stock desactualizados. El JSON-LD tiene que cambiar con la variante y con el inventario, igual que el HTML.
  • Marcar colecciones como productos. Los resultados de producto son para páginas de un solo producto o de sus variantes.
  • Creer que pasar la prueba garantiza estrellas. Te hace elegible. Google decide.
  • Validar en la prueba y olvidarte del informe. La prueba revisa una página; el informe de Search Console te avisa cuando falla en cientos.

Preguntas frecuentes

¿Los datos estructurados mejoran mi posición en Google?

Google no lo presenta así. Sirven para que entienda la página y para que sea elegible a resultados enriquecidos, con precio, stock o estrellas. Lo que puede cambiar es cómo se ve tu resultado, no un lugar garantizado.

¿Necesito una app si mi tema ya usa structured_data?

Para lo obligatorio, no: el filtro ya imprime nombre, imagen, marca y oferta con precio, moneda y disponibilidad. Una app tiene sentido si te falta algo que el tema no cubre, y entonces revisa que no deje dos bloques Product.

¿Cuánto tarda en aparecer el resultado enriquecido?

No hay un plazo. Google tiene que volver a rastrear la página, y aun con todo válido puede no mostrarlo. Si corriges un error del informe, la validación suele tardar unas dos semanas.

¿Puedo probar el JSON-LD sin publicarlo?

Sí: en la Prueba de resultados enriquecidos eliges «Código» y pegas el fragmento. Para probar una URL, la página tiene que ser pública; detrás de una contraseña la herramienta no la ve.

Checklist

  • Cada página de producto tiene un solo bloque Product en JSON-LD.
  • Están name, image y un offers con price mayor que cero y priceCurrency en ISO 4217.
  • availability usa un valor de schema.org y coincide con el stock real.
  • El precio es un número con punto, sin símbolo ni coma.
  • Las reseñas marcadas se ven en la página y vienen de clientes.
  • Envío y devoluciones están en el marcado o configurados en Merchant Center o Search Console.
  • La Prueba de resultados enriquecidos no muestra errores críticos.
  • Revisas «Fragmentos de productos» y «Fichas de comercios» en Search Console.

Los datos estructurados le cuentan a Google qué vendes; lo que falta es que la página cargue rápido y se pueda comprar. Para lo primero, sigue con cómo arreglar el LCP de la imagen principal. Si tus productos tienen problemas en Shopping, revisa por qué Google Merchant Center rechaza productos, y para la base completa, los fundamentos de SEO técnico para Shopify.

¿Viste esto en Instagram? Comenta SEO 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 30 de octubre de 2026 · actualizado el 1 de noviembre de 2026

← Blog