Agregue un objeto JSON-LD Product a cada página de producto que venda directamente. Dentro de él, anide un Offer y haga que su price, priceCurrency, availability e itemCondition coincidan con lo que los compradores ven en la página. Agregue AggregateRating o Review solo cuando esas calificaciones sean visibles en la página y describan ese producto.

Cada función de Google tiene sus propios campos obligatorios, y Merchant Center, Bing y los servicios de búsqueda con IA publican cada uno su propia documentación. Antes de agregar algo, revise lo que ya genera su tema, su aplicación o su plugin, porque un segundo objeto Product puede entrar en conflicto con el primero.

El marcado válido no garantiza un resultado enriquecido, una posición en los resultados, tráfico ni una cita en IA, y un bloque válido con un precio incorrecto no está listo. Escriba el objeto, pruebe la página renderizada y actualícelo cada vez que cambien el precio, las existencias, el envío, las devoluciones o las calificaciones.

Puntos clave

  1. Un Product por páginaColoque un objeto Product con un Offer anidado en cada página que venda directamente. Haga coincidir precio, moneda, disponibilidad y estado con lo que ven los compradores.
  2. Elija la funciónPara los listados de comerciante, Google exige Product.name, Product.image y un Offer con price y priceCurrency. Los fragmentos de producto necesitan name más uno de offers, review o aggregateRating.
  3. Muestre solo valoraciones visiblesIncluya aggregateRating o Review solo si las valoraciones son visibles y describen ese producto. Las valoraciones escritas por el propio vendedor o tomadas prestadas no pertenecen allí.
  4. Coincida con sus políticasDescriba el envío y las devoluciones solo tal como lo indica su política publicada. Google recomienda políticas generales bajo Organization y detalles de producto solo para excepciones.
  5. Mantenga alineado el feedMantenga el precio, la moneda y la disponibilidad iguales en el feed y en la página. Google indica que los datos estructurados no sustituyen las actualizaciones periódicas del feed.
  6. Pruebe y mantenga al díaPruebe la página publicada con la Prueba de resultados enriquecidos y revise Search Console y Merchant Center. Actualice el marcado si cambian precio, stock, envío, devoluciones o valoraciones.

Elija la función de Google que corresponde a su página

Google agrupa el marcado de producto en funciones, y los campos obligatorios cambian entre ellas. La introducción de Google a los productos enumera los fragmentos de producto (product snippets), las fichas de comerciante, Google Images, Google Lens, Popular Products y los paneles de información de compras como lugares donde pueden aparecer los datos de producto. Para una tienda, dos de ellos determinan qué campos completa primero.

Las fichas de comerciante (merchant listings) son para páginas donde los compradores pueden comprar al comerciante. Para esta función de Google, Product.name, Product.image y un Offer anidado con price y priceCurrency son obligatorios. El objeto anidado debe ser un Offer, no solo un AggregateOffer, y el precio debe ser mayor que cero. Los detalles están en la documentación de Google sobre fichas de comerciante.

Los fragmentos de producto cubren páginas de información de producto, reseñas editoriales, agregadores y páginas de producto. Para esta función, Product.name es obligatorio, además de al menos uno de offers, review o aggregateRating, como se describe en la documentación de Google sobre fragmentos de producto. Una página que vende directamente debe seguir los campos de la ficha de comerciante, que incluyen un Offer y, por lo tanto, también cubren el mínimo del fragmento.

Google indica que el marcado válido hace que una página sea elegible para estas apariciones, pero no las garantiza. Trate los campos obligatorios como el punto de partida de cada función y conserve los campos opcionales para los detalles que sean verdaderos y visibles.

Fragmentos de producto y fichas de comerciante

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

PropiedadFragmentos de productoFichas de comerciante
Página indicadaPáginas de información de producto, reseñas editoriales y agregadoresPáginas donde los compradores compran al comerciante
Product.nameObligatorio para esta función de GoogleObligatorio para esta función de Google
Product.imageÚtil cuando correspondaObligatorio para esta función de Google
offersSe requiere uno de offers, review o aggregateRatingSe requiere un Offer anidado, no solo AggregateOffer
aggregateRatingPuede cumplir el requisito de uno entre varios cuando sea auténticaRecomendada, solo cuando sea auténtica y visible

Haga coincidir cada propiedad con algo que los compradores puedan ver

Empiece por la página, no por el código. Anote el nombre del producto, la foto principal, el precio, la moneda, si el artículo está en existencias y si es nuevo, usado o reacondicionado. Cada uno de esos datos tiene una propiedad, y la regla que vale para Google, Bing y Yandex es que el marcado describe lo que la página ya muestra.

Tome como ejemplo una pequeña tienda de cerámica en línea. La propietaria fotografía cada taza sobre un fondo blanco liso y luego anota los mismos datos junto a esa foto: el nombre, el precio en dólares, cuántas quedan y la promesa de envío. El marcado es una segunda copia de esa lista, en un formato que un rastreador puede leer sin tener que adivinar.

Una mujer con delantal de lino fotografía una taza de gres sobre un fondo de papel blanco, en una mesa de trabajo de madera
Figura 1. Los datos que ven los compradores junto a la foto del producto son los que el marcado debe repetir.

En el objeto Product, name es el nombre visible del producto, e image debe apuntar a imágenes rastreables e indexables que representen el producto. Agregue description que coincida con la descripción visible, brand como un Brand u Organization anidado, y sku como su SKU estable. Agregue gtin solo cuando tenga el identificador real, nunca un valor inventado.

En el Offer anidado, estas propiedades hacen el trabajo:

  • price es el precio activo, y priceCurrency es un código ISO 4217 de tres letras, como USD.
  • availability es un valor válido de Schema.org, como InStock u OutOfStock.
  • itemCondition es NewCondition, UsedCondition o RefurbishedCondition.
  • url es la URL de compra, incluida la variante seleccionada cuando eso importa. La guía de variantes de producto cubre las páginas con varias variantes.
  • priceValidUntil es una fecha futura en formato ISO 8601, y Google documenta que una fecha pasada puede impedir que se muestre.

Google marca availability, itemCondition y priceValidUntil como recomendados para las fichas de comerciante, así que agréguelos cuando la información sea verdadera y visible. La definición del tipo Offer en Schema.org explica cada valor si quiere el vocabulario completo.

Escriba un Product y un Offer básicos

Este ejemplo usa una linterna ficticia y example.com. Reemplace cada valor con los datos de su propia página, y coloque el bloque terminado en un elemento <script type="application/ld+json"> del HTML que envía su servidor. El marcado que JavaScript agrega tarde puede no coincidir con la página, sobre todo cuando el precio y las existencias cambian con frecuencia.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/products/example-lantern#product",
  "name": "Example Camp Lantern",
  "image": [
    "https://example.com/images/example-camp-lantern.jpg"
  ],
  "description": "Una linterna de campamento ficticia y recargable, con tres niveles de brillo.",
  "sku": "EX-LANTERN-001",
  "brand": {
    "@type": "Brand",
    "name": "Example Brand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/example-lantern",
    "price": 39.99,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

Este ejemplo funcional deja priceValidUntil fuera a propósito. Si el precio de la página es un precio regular sin fecha de fin, no hay nada que declarar. Si es un precio por tiempo limitado, agregue priceValidUntil, o validThrough para un periodo de oferta, con una fecha de fin que todavía no haya pasado, y quítelo cuando termine la oferta.

El @id da al producto un identificador estable al que puede apuntar otro marcado del sitio. Si conecta productos con una organización o con una ruta de navegación, el constructor de grafos de schema y el generador de schema de ruta de navegación producen marcado que puede compartir los mismos identificadores.

Agregue calificaciones solo cuando los compradores puedan verlas

Agregue aggregateRating cuando la página muestre visiblemente una calificación combinada para este producto. Debe describir este producto, no la tienda en conjunto ni un producto distinto, y las reseñas en las que se basa deben ser auténticas. Las calificaciones que los compradores no pueden ver, que el vendedor escribió sobre sí mismo o que se tomaron de otro artículo no pertenecen al marcado.

En el objeto de calificación, ratingValue y reviewCount son los campos que debe completar. bestRating y worstRating son opcionales cuando la página usa la escala predeterminada de cinco puntos, pero escribirlos elimina cualquier duda sobre la escala. Si la página también muestra reseñas individuales, Review es el tipo para cada una, y la guía de schema de reseñas cubre las reglas para ellas.

Aquí está la misma linterna con una calificación visible de 4.6 a partir de 24 reseñas. Cambie los números para que coincidan con las cifras impresas en su página, y actualícelos cuando cambien las cifras de la página.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/products/example-lantern#product",
  "name": "Example Camp Lantern",
  "image": [
    "https://example.com/images/example-camp-lantern.jpg"
  ],
  "description": "Una linterna de campamento ficticia y recargable, con tres niveles de brillo.",
  "sku": "EX-LANTERN-001",
  "brand": {
    "@type": "Brand",
    "name": "Example Brand"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.6,
    "reviewCount": 24,
    "bestRating": 5,
    "worstRating": 1
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/example-lantern",
    "price": 39.99,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

En los fragmentos de producto, una calificación también puede cumplir el requisito de que esté presente uno de offers, review o aggregateRating. En una página de tienda, conserve también el Offer, para que el mismo bloque sirva a las fichas de comerciante.

Agregue detalles de envío y devolución que coincidan con su política

El envío y las devoluciones son recomendados para las fichas de comerciante cuando los proporciona, y deben coincidir con la política que publica. Google recomienda describir una política de envío para todo el negocio con ShippingService bajo su Organization, y una política de devolución para todo el negocio con MerchantReturnPolicy, también bajo Organization. La guía de schema de organización explica dónde vive ese marcado.

Coloque OfferShippingDetails y hasMerchantReturnPolicy bajo el Offer solo para una excepción que afecte a este producto, o cuando no tenga una política para todo el negocio. Las políticas de devolución a nivel de producto admiten un conjunto más pequeño de propiedades y solo deben sustituir una política global cuando sea necesario. La documentación de Google sobre políticas de envío y la documentación sobre políticas de devolución enumeran cada propiedad admitida.

Una ventana de devolución finita requiere merchantReturnDays, y applicableCountry y returnPolicyCategory son campos de política obligatorios. Reemplace el país, la cantidad de días y los tiempos de entrega de abajo por su política real.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Camp Lantern",
  "image": [
    "https://example.com/images/example-camp-lantern.jpg"
  ],
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/example-lantern",
    "price": 39.99,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": 0,
        "currency": "USD"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "US"
      },
      "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": "US",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnFees": "https://schema.org/FreeReturn",
      "returnMethod": "https://schema.org/ReturnByMail",
      "refundType": "https://schema.org/FullRefund"
    }
  }
}

En su propio marcado, el envío gratuito, los tiempos de entrega y los 30 días deben aparecer todos en la política que los compradores pueden leer. Si un cliente vería una promesa distinta al pagar, cambie el marcado o la política hasta que coincidan.

Haga que Merchant Center y la página coincidan

Google Merchant Center es donde administra las fuentes de datos de productos, incluidos los feeds, y los destinos de compras. Un feed incluye los atributos de producto propios de Google, como título, precio, disponibilidad, identificadores, imágenes, envío y devoluciones. Los datos estructurados de la página son una fuente aparte que describe el producto visible.

Tres tarjetas para una página, su código y un feed de datos, con formas de precio, existencias y estrellas que coinciden y están unidas por líneas azules
Figura 2. La página, el marcado y el feed de Merchant Center deben contar la misma historia sobre precio y existencias.

Google indica que los datos estructurados pueden respaldar las actualizaciones automáticas de artículos y las fuentes de datos de productos del rastreo del sitio web. No reemplazan las actualizaciones periódicas del feed, así que la página y el feed deben seguir en su rutina. La página de datos estructurados de Merchant Center de Google explica la ruta del marcado en el sitio web, y las instrucciones de configuración cubren la implementación de Product y Offer y sus pruebas.

El precio, la moneda, la disponibilidad, la condición, los identificadores y las URL de la página de destino deben coincidir entre el feed y la página. Merchant Center informa por separado de los rechazos, las discrepancias, los atributos faltantes y los problemas de políticas, distintos de Search Console. Su especificación de datos de producto enumera los atributos del feed, que no son idénticos a los nombres de propiedad de Schema.org.

Revise lo que ya genera su plataforma

Abra una página de producto, vea el HTML renderizado o pase la URL por la Prueba de resultados enriquecidos (Rich Results Test), y cuente cuántos objetos Product aparecen. Si su tema, aplicación o plugin ya imprime uno, corríjalo ahí o desactive esa salida antes de agregar un segundo bloque. Dos objetos para un mismo producto pueden no coincidir en el precio o la disponibilidad.

El centro de ayuda de Shopify describe los datos estructurados que genera el tema en el mapa del sitio y el marcado del tema, y lo que imprime un tema varía según el tema. Shopify también recomienda usar datos estructurados y atributos de producto en su artículo sobre optimización de la tienda para IA, que es una recomendación de Shopify y no un requisito de Google.

Wix describe el marcado de producto preestablecido y las opciones de SEO editables en su artículo sobre SEO de páginas de producto. Squarespace dice que agrega datos estructurados de producto automáticamente y que los esquemas generados no pueden editarse ni eliminarse, en su artículo de ayuda sobre optimización para búsqueda. En Squarespace, la palanca es mantener exactos el nombre, el precio y las existencias del propio producto.

El artículo de ayuda de Webflow sobre marcado schema, con fecha del 27 de enero de 2026, cubre el marcado manual y el generado con IA, así como su validación. Indica que los campos de las páginas construidas con datos de producto deben estar vinculados a los valores correctos. Lo que imprime WordPress depende de su tema y de cualquier plugin de tienda o de SEO, así que lea el HTML renderizado para verlo.

En un sitio hecho a mano o en Next.js, usted controla el resultado. La guía de JSON-LD de Next.js, actualizada por última vez el 27 de febrero de 2026, cubre cómo colocar el JSON-LD, sanitizarlo y probarlo con la Prueba de resultados enriquecidos y con el Schema Markup Validator. No define para qué funciones de producto de Google califica una página. Para eso, vuelva a los requisitos de arriba.

Si prefiere llenar un formulario, el generador de schema de producto construye el objeto a partir de los datos que ingrese. Reemplace sus valores de ejemplo por los datos de su página antes de copiar el resultado.

Pruebe la página renderizada y luego revise los informes

La validez tiene varios niveles, y cada uno necesita su propia prueba. La sintaxis JSON debe analizarse correctamente, el vocabulario de Schema.org debe usarse bien, la página debe cumplir los requisitos de la función de Google que quiere, y después Google tiene que rastrearla y decidir mostrarla. Pasar un nivel no significa pasar el siguiente.

  1. Ejecute la URL activa por la Prueba de resultados enriquecidos de Google antes y después de publicar, para probar el HTML que reciben los compradores y los rastreadores.
  2. Revise la sintaxis JSON con el validador de schema si la prueba informa un error de análisis.
  3. Después de que Google rastree la página, abra el informe «Merchant listings» (fichas de comerciante) de Search Console para las páginas que venden directamente. El informe «Product snippets» (fragmentos de producto) se necesita sobre todo para las páginas de producto que no son páginas de fichas de comerciante.
  4. Use el informe «Unparsable structured data» (datos estructurados no analizables) para las fallas de sintaxis, «URL Inspection» (inspección de URL) para ver el HTML que obtuvo Google, y el informe «Manual Actions» (acciones manuales) si Google ha aplicado una acción sobre datos estructurados.
  5. Revise los diagnósticos de Merchant Center para detectar problemas de feed, precio, disponibilidad, identificadores y políticas.

Bing Webmaster Tools tiene una tarjeta «Markup» (marcado) en su herramienta de inspección de URL. Reconoce JSON-LD, Microdata, Microformats y Open Graph, así que úsela cuando el tráfico de Bing sea importante para su tienda. Yandex ofrece su propio validador de datos estructurados.

Haga que el marcado sea legible para Bing y la búsqueda con IA

El mismo bloque Product sirve a Bing, que lee Schema.org en JSON-LD, Microdata, RDFa, Microformats y Open Graph, y enumera los productos y las ofertas como un escenario compatible (documentación de datos estructurados de Bing). Yandex usa Product con Offer o AggregateOffer para los fragmentos de producto, y pide un solo producto por página; las páginas con productos distintos no forman fragmentos de producto (página de ayuda sobre información de productos).

Para que la búsqueda de ChatGPT llegue a sus páginas de producto, permita OAI-SearchBot en robots.txt (documentación de rastreadores de OpenAI). La búsqueda web de Copilot puede fundamentar sus respuestas en los resultados de Bing (documentación de búsqueda web de Copilot), así que la forma en que Bing ve la página importa ahí. Mantenga el precio, la disponibilidad, las especificaciones y las reseñas en el HTML visible, y decida por separado si permite cada rastreador. Para el panorama más amplio, vea si los sistemas de IA usan el marcado schema.

Corrija los errores que rompen el marcado de producto

La mayoría de los problemas vienen de un marcado que se ha desviado de la página. Estos son los que conviene revisar primero:

  • El precio en el marcado difiere del precio visible o del precio de pago.
  • priceCurrency falta o no es un código ISO 4217.
  • priceValidUntil tiene una fecha pasada.
  • availability dice InStock mientras la página dice agotado.
  • Una página de categoría marca varios productos no relacionados como un solo Product.
  • Una página que vende directamente usa solo AggregateOffer en lugar de un Offer.
  • Las calificaciones están ocultas, las escribió el vendedor o describen otro producto.
  • Una página de variante reutiliza el precio, la URL, la imagen, el SKU o la disponibilidad del producto principal.
  • Dos plugins, o un tema y un plugin, generan objetos Product en conflicto.

El bloque de abajo está roto a propósito, así que no lo copie. La página muestra un precio de 39.99 y una etiqueta de agotado, pero el marcado dice 29.99 y InStock. Además, su priceValidUntil ya pasó, y Google documenta que una fecha pasada puede impedir que se muestre.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Camp Lantern",
  "image": [
    "https://example.com/images/example-camp-lantern.jpg"
  ],
  "offers": {
    "@type": "Offer",
    "price": 29.99,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "priceValidUntil": "2025-12-31"
  }
}

Este bloque es JSON válido y usa propiedades reales de Schema.org, así que una revisión de sintaxis lo aprueba. Aun así, no pasa la prueba que importa aquí, porque el marcado y la página cuentan historias distintas. La solución es cambiar el marcado a 39.99 y OutOfStock, y eliminar la fecha vieja.

Actualice el marcado cada vez que cambie el producto

Escriba un objeto Product que coincida con una página real, y repita el proceso para cada producto que se pueda comprar. Cuando cambien el precio, las existencias, el envío, las devoluciones o las calificaciones, el marcado cambia con ellos, y una plantilla que lee esos valores de sus datos de producto lo hace sin ediciones manuales.

Los requisitos de las funciones cambian con el tiempo, así que lea la documentación vigente de Google antes de confiar en cualquier tabla de propiedades, y use la Prueba de resultados enriquecidos otra vez después de cada cambio de plantilla. El marcado válido hace que una página sea elegible para una aparición. No promete esa aparición.

Pasos para configurar el marcado de producto

Siga estos pasos en orden para cada página de producto.

  1. Elija una URLIdentifique una URL canónica de producto para el artículo.
  2. Compare con la páginaConfirme que la página muestra el nombre, la imagen, el precio, la moneda, la disponibilidad y una opción de compra.
  3. Agregue Product y OfferAgregue un objeto Product con un Offer del vendedor.
  4. Agregue calificacionesAgregue datos de calificación o de reseña solo cuando sean visibles y correspondan a este producto.
  5. Agregue políticasAgregue los detalles de envío y devolución que coincidan con su política publicada.
  6. Pruebe y luego superviseValide, revise Search Console y Merchant Center después del rastreo, y actualice cuando cambien los datos.

Preguntas frecuentes

¿Qué es el marcado schema de producto y qué puede mostrar?

El marcado schema de producto es un objeto Product, normalmente escrito en JSON-LD, que describe un artículo y su oferta. Según el proveedor y la página, esos datos pueden respaldar detalles como precio, disponibilidad, calificaciones, envío y devoluciones. Cada proveedor decide qué muestra, y ninguno promete mostrarlo.

¿Necesito Google Merchant Center?

El marcado de producto en la página y un feed de Merchant Center son formas separadas de dar a Google datos de producto. Merchant Center es donde administra las fuentes de datos de productos y los destinos de compras, y los datos estructurados pueden respaldar las fuentes de rastreo del sitio web y las actualizaciones automáticas de artículos. Si usa ambos, mantenga sus valores en coincidencia.

¿Puedo agregar calificaciones sin reseñas visibles?

No. Agregue AggregateRating o Review solo cuando las calificaciones y las reseñas sean visibles en la página y describan ese producto. El marcado de calificaciones que los compradores no pueden ver, o que pertenecen a otro producto, no coincide con la página.

¿Debo incluir políticas de envío y devolución?

Inclúyalas cuando tenga una política publicada, porque Google las recomienda para las fichas de comerciante. Describa las políticas de todo el negocio bajo Organization, y use OfferShippingDetails o hasMerchantReturnPolicy a nivel de producto para las excepciones. Cada valor debe coincidir con la política que los compradores pueden leer.

¿Por qué Google muestra un precio distinto al de mi página?

Lo primero que debe descartar es una discrepancia entre el marcado, el feed y el precio visible. Compare el price y el priceCurrency del HTML renderizado con la página y con el pago, y revise si un tema o un plugin agrega un segundo objeto Product. Después, revise si priceValidUntil tiene una fecha pasada.

¿El schema de producto ayuda a la búsqueda con IA?

Google indica que AI Overviews y AI Mode no necesitan marcado especial más allá de la elegibilidad normal para la Búsqueda, y OpenAI documenta OAI-SearchBot para la búsqueda de ChatGPT. Los datos visibles del producto y un marcado que coincida con ellos sirven a todos los lectores, y nada garantiza una cita en IA.

Revisión rápida

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

Pregunta 1 de 3

Una página de producto tiene JSON-LD válido, pero el precio del marcado difiere del precio visible. ¿Está lista?

Pregunta 2 de 3

¿Qué objeto anidado requieren las fichas de comerciante en una página que vende directamente?

Pregunta 3 de 3

Su tema puede imprimir datos de Product. ¿Qué debe hacer primero?

Términos del marcado de producto

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

Datos estructurados (structured data). Información legible por máquinas que describe el contenido visible de la página.