Además del marcado de producto, agregue una entidad OnlineStore u Organization para la tienda, una política de devoluciones y una política de envíos para toda la tienda, y marcado BreadcrumbList en las páginas que muestren una ruta visible. Agregue detalles de envío o devolución a un producto concreto solo cuando difieran de esas políticas. Conviene agregar un feed de Merchant Center cuando quiera aparecer en la pestaña Shopping o controlar mejor las actualizaciones de productos.
Siga este orden: primero el grafo de la tienda, luego una página de producto, después la ruta de navegación y al final las pruebas.
Google indica que los datos estructurados pueden hacer que las páginas sean elegibles para las funciones de búsqueda compatibles, pero no garantizan que se muestren, y Bing indica que las anotaciones no garantizan fragmentos enriquecidos (rich snippets). Trate el marcado como una descripción precisa de sus páginas, no como una promesa de aparición en los resultados.
Describa una vez la tienda, sus devoluciones y sus envíos
Empiece por la entidad que sostiene todo lo demás. OnlineStore es un subtipo de Organization en Schema.org para un sitio de comercio electrónico, así que incluye las mismas propiedades: name, url, logo, datos de contacto, una dirección cuando corresponda y enlaces sameAs a perfiles que realmente le pertenecen. Colóquelo en la página de inicio o en una página que describa el negocio. La documentación de Organization de Google no enumera propiedades requeridas para esa función y recomienda los datos del negocio mencionados arriba. La guía de schema de Organization explica las propiedades con más detalle.
El ejemplo siguiente es un solo grafo conectado para una tienda ficticia. La tienda apunta a una política de devoluciones y a un servicio de envío mediante @id, un identificador estable con forma de URL que permite que una entidad se refiera a otra sin repetirla. Reemplace cada valor por los suyos y mantenga los valores de @id de las políticas apuntando a páginas de políticas reales de su dominio.

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "OnlineStore",
"@id": "https://example.com/#store",
"name": "Example Lantern Shop",
"url": "https://example.com/",
"logo": "https://example.com/images/logo.png",
"telephone": "+1-555-010-0147",
"sameAs": ["https://social.example.com/example-lantern-shop"],
"hasMerchantReturnPolicy": { "@id": "https://example.com/policies/returns#policy" },
"hasShippingService": { "@id": "https://example.com/policies/shipping#service" }
},
{
"@type": "MerchantReturnPolicy",
"@id": "https://example.com/policies/returns#policy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn",
"merchantReturnLink": "https://example.com/policies/returns"
},
{
"@type": "ShippingService",
"@id": "https://example.com/policies/shipping#service",
"name": "Standard shipping",
"fulfillmentType": "https://schema.org/FulfillmentTypeDelivery",
"shippingConditions": [
{
"@type": "ShippingConditions",
"shippingDestination": { "@type": "DefinedRegion", "addressCountry": "US" },
"shippingRate": { "@type": "MonetaryAmount", "value": 0, "currency": "USD" },
"transitTime": {
"@type": "ServicePeriod",
"duration": {
"@type": "QuantitativeValue",
"minValue": 3,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
]
}
]
}Una política de devoluciones estándar debe ir bajo la organización mediante hasMerchantReturnPolicy. Para la función de política de devoluciones de Google, applicableCountry y returnPolicyCategory son requeridas, y merchantReturnDays es requerida cuando la política usa MerchantReturnFiniteReturnWindow. Use marcado de devolución a nivel de producto solo para las excepciones, o cuando la tienda no tenga una política estándar.
Una política de envío estándar debe ir bajo la organización mediante hasShippingService. La documentación de política de envío de Google enumera shippingConditions como requerida para esa función, con los destinos, las tarifas y los plazos de entrega descritos dentro. Si las mismas reglas de envío cubren la mayor parte del catálogo, un solo ShippingService es más fácil de mantener que una copia en cada página de producto.
La precedencia importa cuando también usa otras configuraciones. El anuncio de Google de noviembre de 2025 sobre cómo compartir políticas de envío y devolución indica que la configuración de políticas de Search Console puede tener precedencia sobre el marcado a nivel de organización. Su documentación de fichas de comerciante indica que los datos del feed a nivel de producto tienen la mayor precedencia, seguidos por la configuración de Content API y después por la de Merchant Center o Search Console. Decida qué origen controla cada política y cámbiela allí.
Agregue Product, Offer y el envío a nivel de producto en cada página de producto
Una página de producto incluye la entidad Product con un Offer dentro. Google requiere name, image y offers para las fichas de comerciante, y Offer necesita price y priceCurrency, o un priceSpecification equivalente, para un precio activo. Campos como sku, brand.name, description, availability, itemCondition y url son recomendados u opcionales. La guía de schema de producto explica cada propiedad, y el generador de schema de producto crea el bloque con sus propios datos.
El siguiente ejemplo muestra un solo producto con detalles de envío distintos de la política de la tienda. El seller apunta de vuelta a la entidad de la tienda mediante @id, así que el producto y la tienda siguen conectados. Para un producto que sigue sus políticas globales de envío y devolución, elimine las líneas shippingDetails y hasMerchantReturnPolicy y la entidad OfferShippingDetails. Cambie el precio, la moneda, la disponibilidad y los plazos de entrega para que coincidan con lo que la página muestra hoy.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Product",
"@id": "https://example.com/products/aurora-lantern#product",
"name": "Aurora Desk Lantern",
"image": [
"https://example.com/images/aurora-lantern-1x1.jpg",
"https://example.com/images/aurora-lantern-4x3.jpg",
"https://example.com/images/aurora-lantern-16x9.jpg"
],
"description": "Una lámpara de escritorio recargable y ficticia con tres niveles de brillo.",
"sku": "AURORA-001",
"brand": { "@type": "Brand", "name": "Example Lantern Shop" },
"offers": {
"@type": "Offer",
"url": "https://example.com/products/aurora-lantern",
"price": 49.95,
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"itemCondition": "https://schema.org/NewCondition",
"seller": { "@id": "https://example.com/#store" },
"shippingDetails": { "@id": "https://example.com/products/aurora-lantern#shipping" },
"hasMerchantReturnPolicy": { "@id": "https://example.com/policies/returns#policy" }
}
},
{
"@type": "OfferShippingDetails",
"@id": "https://example.com/products/aurora-lantern#shipping",
"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": 3, "maxValue": 5, "unitCode": "DAY" }
}
}
]
}Para la función de detalles de envío de Google, OfferShippingDetails necesita deliveryTime, shippingDestination, shippingRate y la moneda del envío. Dentro de deliveryTime, handlingTime y transitTime son recomendados. Una propiedad puede ser perfectamente válida en Schema.org y, aun así, no ser requerida por una función concreta de Google. Si sus productos vienen en tallas o colores, la guía de schema de variantes de producto explica cómo describirlos.
Agregue la ruta de navegación a las páginas de producto y de categoría
Use BreadcrumbList en cualquier página con una ruta significativa dentro del sitio, y solo cuando la página muestre esa ruta. Google requiere itemListElement y al menos dos elementos. Cada ListItem necesita un position y un name, además de una URL item en cada entrada excepto la última, donde Google puede usar la URL de la página actual. Google recomienda describir la ruta típica que sigue un visitante, no copiar mecánicamente la estructura de URL.
El ejemplo corresponde a la página de la lámpara de arriba. Cambie los nombres y las URL por la ruta que su página realmente muestra, y conserve como último elemento el propio producto. La guía de schema de ruta de navegación cubre los sitios con más de una ruta hacia un producto, y el generador de schema de ruta de navegación crea la lista a partir de su propio recorrido.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"@id": "https://example.com/products/aurora-lantern#breadcrumbs",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
{
"@type": "ListItem",
"position": 2,
"name": "Lighting",
"item": "https://example.com/collections/lighting"
},
{
"@type": "ListItem",
"position": 3,
"name": "Aurora Desk Lantern",
"item": "https://example.com/products/aurora-lantern"
}
]
}Marque las páginas de categoría según lo que muestran
Una página de categoría o de colección es una lista de productos, no un solo producto. Google indica que la elegibilidad para el resultado enriquecido de Product se centra en páginas de un solo producto o de variantes de uno, y recomienda las páginas de producto antes que las páginas de listado o de categoría. Poner un Product en una página de categoría, o un precio tomado del primer artículo de la cuadrícula, describe algo que la página no ofrece.
Dé a la página de categoría el vocabulario que le corresponde. Agregue BreadcrumbList cuando exista una ruta de navegación visible. Agregue CollectionPage o WebPage solo cuando la página represente realmente esa entidad. Agregue ItemList solo cuando la página presente de forma visible una lista ordenada o seleccionada y el marcado refleje esa lista. Google no tiene una función de resultado enriquecido para el marcado genérico ItemList de páginas de categoría comparable a las fichas de comerciante, así que trátelo como vocabulario de Schema.org y no como una visualización prometida.
Lo que más importa en una página de categoría es el HTML simple: enlaces visibles a cada producto y un texto claro sobre la categoría. Omita precios, calificaciones, reseñas, existencias y reglas de envío que no sean visibles y exactos en la página. No marque productos ocultos, productos que solo vende otro minorista ni reseñas que usted haya escrito sobre su propio negocio.
Mantenga los precios, las existencias y las políticas iguales en la página y en el feed
Use el marcado de la página y un feed de Merchant Center juntos cuando pueda. Google indica que los datos estructurados le ayudan a entender y verificar los datos de producto, que Merchant Center le ofrece una fuente de datos específica para comercio, y que Merchant Center es requerido para algunas superficies, incluida la pestaña Shopping. Un bloque JSON-LD por sí solo no reemplaza el feed cuando quiere esas superficies.

Cada uno de estos valores debe decir lo mismo en la página visible, en el JSON-LD y en el feed: el título y la descripción del producto, la URL del producto y la URL canónica, identificadores como el SKU, el GTIN (identificador global de artículo comercial) o el MPN, el precio y la moneda, la disponibilidad, las variantes, el costo y el plazo del envío, la política de devoluciones y las imágenes del producto. Una discrepancia puede producir advertencias, precios desactualizados, un estado de existencias incorrecto o información de envío contradictoria.
La práctica recomendable es cambiar el origen que controla los datos y luego probar otra vez la página y el feed. Si su plataforma genera el marcado a partir del registro del producto, edite el registro, no el resultado. Si un desarrollador escribe el JSON-LD a mano, genere el precio y la disponibilidad a partir de los mismos campos de la base de datos que los imprimen en la página, para que una oferta o un agotamiento de existencias no actualice uno y omita el otro.
Revise qué genera ya su plataforma
Una plataforma puede generar ya marcado de producto por usted, así que revise la página renderizada antes de agregar algo. Abra la página de producto en vivo, vea el código fuente o use una herramienta de prueba, y enumere cada bloque Product, Offer y BreadcrumbList que pueda ver. La documentación de soporte de Wix describe el marcado de producto preestablecido para Wix Stores y sus campos de producto, y su artículo sobre SEO para comercio electrónico menciona los detalles de envío y la ruta de navegación.
Para las demás plataformas, el resultado depende del tema, las aplicaciones y los plugins vigentes, así que lea el HTML renderizado y la configuración de SEO de la plataforma en lugar de suponerlo. Las guías de cada plataforma cubren las rutas de instalación: Shopify, WordPress, Wix, Squarespace, Webflow y HubSpot.
Si dos fuentes describen el mismo producto, elimine o desactive una antes de agregar más. Dos bloques Product en conflicto en una misma página pueden no coincidir en precio o disponibilidad, y la guía de marcado schema duplicado muestra cómo encontrarlos y resolverlos. Cuando el bloque de la plataforma está casi completo pero incompleto, ampliarlo suele ser más limpio que agregar un segundo bloque junto a él.
En un sitio hecho a mano, renderice el JSON-LD en el servidor. La documentación de Next.js (actualizada en febrero de 2026) explica cómo renderizar JSON-LD en layout.js o page.js, sanear los valores serializados y probar con la Prueba de resultados enriquecidos o con Schema Markup Validator. La guía de JSON-LD en Next.js y React va más allá, y el constructor de grafos schema puede armar un grafo conectado como los de arriba.
Si su negocio también atiende clientes en una dirección física, la guía de schema de negocio local cubre ese lado.
Valide cada página y manténgala actualizada
Pruebe una página de cada tipo: la página de inicio, una página de producto, una página de categoría y las páginas de políticas. La Prueba de resultados enriquecidos de Google revisa la elegibilidad para las funciones de Google, y Schema Markup Validator revisa las relaciones del vocabulario. Responden preguntas distintas. El validador schema de Schema Nova puede revisar la sintaxis JSON antes que cualquiera de las dos, y la guía sobre la Prueba de resultados enriquecidos frente al validador de Schema explica cuándo usar cada herramienta.
Después de publicar, inspeccione la URL en vivo en Search Console, solicite un nuevo rastreo cuando corresponda y mantenga actualizado el mapa del sitio. Luego mantenga el marcado al día: cada vez que cambie un precio, un estado de existencias, un plazo de entrega o un plazo de devolución, la página, el marcado y el feed deben cambiar juntos. La lista de funciones compatibles de Google también cambia con el tiempo, y su página de actualizaciones de la documentación es el lugar para vigilar las funciones retiradas o modificadas.
Haga que el marcado de producto sea legible para Bing y la búsqueda con IA
Bing lee JSON-LD, Microdata y RDFa, así que el mismo marcado de producto, de oferta y de ruta de navegación sirve para ambos motores. La documentación de datos estructurados de Bing y sus directrices para webmasters insisten en datos estructurados precisos, contenido visible y HTML claro, y Bing Webmaster Tools ofrece validación y monitoreo. Si vende a usuarios de Yandex, su validador de marcado semántico revisa el mismo marcado.
Para aparecer en ChatGPT Search, permita que OAI-SearchBot rastree el sitio. Sea cual sea el sistema al que apunte, mantenga los productos, las políticas y los precios visibles en HTML. El marcado no promete una visualización, una cita ni tráfico. Consulte si la IA usa el marcado schema para la comparación, y la guía de resultados enriquecidos para saber qué esperar de las visualizaciones de Google.
Preguntas frecuentes
¿Necesito Merchant Center si ya uso JSON-LD?
Google indica que los datos estructurados y Merchant Center se pueden usar juntos, y que Merchant Center es requerido para algunas superficies, incluida la pestaña Shopping. El JSON-LD describe la página; el feed le da a Google una fuente de datos comerciales aparte. Mantenga ambos sincronizados si usa los dos.
¿Debo poner OnlineStore en cada página?
Póngalo en la página de inicio o en una página que describa el negocio, con un @id estable como https://example.com/#store. Así, las páginas de producto pueden apuntar a él desde seller sin describir la tienda otra vez. La guía de schema de Organization en cada página cubre la cuestión en detalle.
¿Puedo usar schema de Product en una página de categoría?
Google indica que la elegibilidad para el resultado enriquecido de Product se centra en páginas de un solo producto o de variantes de uno, así que una página de categoría no es el lugar para él. Use BreadcrumbList, y CollectionPage o ItemList solo cuando coincidan con lo que la página muestra de forma visible.
¿Cada producto debe tener su propio marcado de envío?
No, cuando una sola política cubre la mayor parte del catálogo. Coloque un ShippingService bajo la tienda y agregue OfferShippingDetails a un producto solo cuando su tarifa, su destino o su plazo de entrega sean distintos. El mismo criterio se aplica a las políticas de devolución.
¿Qué hago si el marcado de la plataforma duplica el mío?
Revise la página renderizada y enumere cada bloque de producto y de ruta de navegación. Conserve una sola fuente para cada entidad, elimine o desactive la adicional y pruebe otra vez con la Prueba de resultados enriquecidos y con Schema Markup Validator.
