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)
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.
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:
| Propiedad | Nivel | Qué poner |
|---|---|---|
name | Obligatoria | El nombre del producto, como aparece en la página. |
image | Obligatoria | Una o más URL rastreables. Google recomienda varias en alta resolución, en proporciones 16x9, 4x3 y 1x1. |
offers | Obligatoria | Un Offer anidado. Tú tienes que ser el vendedor. |
offers.price | Obligatoria | El precio actual, como número y mayor que cero. |
offers.priceCurrency | Obligatoria | Código ISO 4217 de tres letras: MXN, USD, EUR. |
offers.availability | Recomendada | Un solo valor, como https://schema.org/InStock u OutOfStock. |
offers.itemCondition | Recomendada | NewCondition, RefurbishedCondition o UsedCondition. |
brand, sku, gtin, mpn | Recomendadas | Identificadores del producto. Si tienes GTIN reales, inclúyelos. |
aggregateRating, review | Recomendadas | Solo si las reseñas son de clientes y se ven en la página. |
shippingDetails, hasMerchantReturnPolicy | Recomendadas | Enví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.
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:
<script type="application/ld+json">: el contenedor. El navegador no lo pinta; Google lo lee. Puede ir en el<head>o en el<body>.@contexty@type: el vocabulario (schema.org) y el tipo de cosa que describes, unProduct.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.skuybrand: identificadores. Con un GTIN real (código de barras) sumagtin13o el que corresponda; no lo inventes.aggregateRating: la media (ratingValue) y cuántas reseñas (reviewCount). SinbestRating, Google asume una escala de 5. Quita este bloque si las reseñas no se ven en la página.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.shippingDetails: costo de envío, país de destino, días de preparación (handlingTime) y de tránsito (transitTime), enDAY.hasMerchantReturnPolicy: país, tipo de política, 30 días para devolver, devolución por correo y sin costo. ConMerchantReturnFiniteReturnWindow,merchantReturnDayses 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.| jsonen cada texto: si el título trae comillas, comoTaza "azul", el JSON sigue siendo válido. Escribir"{{ product.title }}"a mano lo rompe.if product.featured_imageeif 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_urldevuelve una URL que empieza con//; la completamos.prepend: request.origin:variant.urles relativa;request.originle pone el protocolo y el dominio de la tienda.divided_by: 100.0: Liquid da los precios en centavos; dividir entre100.0da un decimal con punto. Shopify advierte que no usesmoney_without_currencypara elpricede 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:InStockuOutOfStocksegú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:
- 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.
- 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,noindexo un inicio de sesión. - 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.
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 habitual | Causa probable | Arreglo |
|---|---|---|
Falta offers, review o aggregateRating | Solo hay name e image | Añade el Offer con precio y moneda |
Valor de price no válido | Precio con coma o símbolo: "349,00", "$349" | Número con punto: 349.00 |
Falta priceCurrency | Moneda sin declarar o con símbolo | Código ISO 4217: MXN |
| Error de análisis | Comillas sin escapar en el nombre o una coma de más | Usa | 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
Productcon 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_currencyo un precio con coma decimal dejan unpriceinvá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
Producten JSON-LD. - Están
name,imagey unoffersconpricemayor que cero ypriceCurrencyen ISO 4217. availabilityusa 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

Publicado el 30 de octubre de 2026 · actualizado el 1 de noviembre de 2026