¿Qué es Schema.org?

Cuando el tema de tu tienda, una aplicación o una agencia te dicen que «falta schema», están hablando de Schema.org: la lista de palabras con la que se escriben la mayoría de los datos estructurados que lee Google.⁠^{[1]Google Search Central. Introduction to structured data markup in Google Search} Es una web y es un vocabulario. No es un plugin, no es un formato de código y no es una herramienta de Google, aunque Google sea uno de sus fundadores. Te importa porque es lo que hace que «producto», «precio» o «marca» signifiquen exactamente lo mismo para tu tienda, para Google y para cualquier otro programa que lea tus fichas.

Cómo funciona

Schema.org se define como una actividad comunitaria y colaborativa cuya misión es crear, mantener y promover esquemas para datos estructurados en internet, en páginas web, en correos electrónicos y más allá. Lo fundaron Google, Microsoft, Yahoo y Yandex.⁠^{[2]Schema.org. Schema.org} Desde abril de 2015, el foro principal del proyecto es el Schema.org Community Group del W3C, que prepara las versiones, y un grupo de dirección con representantes de esos buscadores las aprueba y publica.⁠^{[3]Schema.org. About Schema.org}

El vocabulario se organiza en tipos y propiedades, en una jerarquía que empieza en Thing (cosa) y se abre en obras creativas, eventos, organizaciones, personas, lugares y productos. La versión V30.1, del 16 de septiembre de 2026, tiene 826 tipos, 1.540 propiedades, 19 tipos de dato, 96 enumeraciones y 544 valores de enumeración.⁠^{[4]Schema.org. Organization of Schemas}

Un tipo es una clase de cosa. Product, por ejemplo, es «cualquier producto o servicio que se ofrece», y Schema.org pone como ejemplos unos zapatos, una entrada de concierto, el alquiler de un coche o un corte de pelo. Cuelga directamente de Thing y tiene propiedades como name, description, sku, gtin, brand, image u offers.⁠^{[5]Schema.org. Product} Una propiedad puede apuntar a otro tipo: offers lleva a Offer, que describe las condiciones de venta. Y una enumeración es una lista cerrada de valores, como los de disponibilidad: Google pide escribirlos como direcciones del vocabulario, del tipo https://schema.org/InStock.⁠^{[6]Google Search Central. Merchant listing (Product, Offer) structured data}

Dos zonas del vocabulario conviene conocer. La sección pending es la zona de pruebas de los términos nuevos que aún se discuten, y Schema.org avisa de que pueden no tener consenso y que su nombre o su definición pueden cambiar mucho. El attic guarda los términos retirados o rechazados, y se desaconseja usarlos.⁠^{[4]Schema.org. Organization of Schemas}

Schema.org no impone un formato. El mismo vocabulario se puede escribir con RDFa, microdatos o JSON-LD, y según el propio proyecto, en 2024 más de 45 millones de dominios marcaban sus páginas con más de 450.000 millones de objetos de Schema.org.⁠^{[2]Schema.org. Schema.org}

En una tienda

Para ver qué hace Schema.org y qué no, sigue un solo dato, el precio de una ficha, por las tres capas que intervienen. Ejemplo ficticio: el producto y el precio son inventados.

Schema.org es solo la primera capa; el formato y los requisitos se deciden en otro sitio. Lo práctico de separarlas es saber a quién preguntar: si dudas de qué significa una propiedad, lee Schema.org; si dudas de si Google la tiene en cuenta, lee la documentación de Google. Google lo dice así: la mayoría de los datos estructurados de su buscador usan el vocabulario de Schema.org, pero para saber cómo se comporta la Búsqueda la referencia definitiva es su documentación, no la de Schema.org.⁠^{[1]Google Search Central. Introduction to structured data markup in Google Search}

Y dentro del vocabulario, elige con precisión. Google pide usar el tipo y las propiedades más específicos que Schema.org defina para lo que marcas.⁠^{[8]Google Search Central. General structured data guidelines} Bajo Product, por ejemplo, Schema.org lista tipos más concretos como ProductGroup, ProductModel o IndividualProduct.⁠^{[5]Schema.org. Product}

Cómo comprobarlo

1. Abre la página del tipo en Schema.org, por ejemplo schema.org/Product. Verás de qué tipo cuelga, sus propiedades y los tipos más específicos, y al pie, la versión del vocabulario.⁠^{[5]Schema.org. Product}
2. Busca cada propiedad de tu marcado en esa página. Si no aparece, o aparece en la sección pending o en el attic, no la trates como estable.⁠^{[4]Schema.org. Organization of Schemas}
3. Pasa tu código por un validador de schema para ver si respeta el vocabulario, y después por la Prueba de resultados enriquecidos para ver qué entiende Google de él.
4. Abre la documentación de Google del resultado que buscas (para una tienda, la de fichas de comerciante) y marca qué propiedades pide como obligatorias y cuáles como recomendadas.⁠^{[6]Google Search Central. Merchant listing (Product, Offer) structured data}

Concepto cercano: JSON-LD

Schema.org son las palabras; JSON-LD es una de las maneras de escribirlas en la página. Una misma ficha descrita con el mismo vocabulario se puede escribir en JSON-LD, en microdatos o en RDFa.⁠^{[2]Schema.org. Schema.org} Google admite los tres y recomienda JSON-LD.⁠^{[1]Google Search Central. Introduction to structured data markup in Google Search} Por eso «tenemos schema» y «tenemos JSON-LD» no son la misma frase: la primera habla de qué se dice y la segunda, de cómo está escrito. Y schema markup, la expresión inglesa que oirás en las propuestas, es el marcado hecho con este vocabulario, sin decir en qué formato.

Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y la página de JSON-LD explica el formato que recomienda Google.