# Validador de datos estructurados Introduce la dirección de una página para leer su JSON-LD tal como lo ve un navegador después de ejecutar los scripts. El validador enumera todos los tipos de schema.org, detecta los bloques que los buscadores no pueden analizar y compara cada elemento con las propiedades obligatorias y recomendadas de la documentación de Google. ## Qué comprueba esta herramienta - Errores de sintaxis JSON: Cada bloque JSON-LD se analiza como lo haría un buscador. Un bloque con una coma o unas comillas de más se indica con el mensaje del analizador, porque los buscadores ignoran el bloque entero. - El contexto de schema.org: Se señalan los bloques sin "@context": "https://schema.org", ya que los buscadores no pueden saber qué vocabulario usan. - Todos los elementos, incluido @graph: Los elementos del nivel superior y los de dentro de @graph, además del mainEntity y el breadcrumb de una página, cada uno con su tipo y su nombre o titular. - Las propiedades obligatorias de Google: Los elementos Product, Article, Breadcrumb, Organization, empresa local, Event, Video, Recipe, aplicación de software, oferta de empleo y nombre del sitio (WebSite) se comparan con lo que Google marca como obligatorio. - Propiedades recomendadas: Lo que Google recomienda para cada resultado enriquecido, como image y availability para los productos, o datePublished y author para los artículos. - Resultados enriquecidos retirados: Los elementos FAQPage y HowTo aparecen con una nota: Google ya no muestra estos resultados enriquecidos, así que el marcado no conseguirá ninguno. - Marcado añadido con JavaScript: La página se ejecuta en Chrome antes de que la leamos, así que se incluye el JSON-LD que insertan los scripts o un gestor de etiquetas. ## Qué no puede comprobar - Garantizar un resultado enriquecido. Google decide si lo muestra; un marcado válido solo permite que una página opte a él. - Comprobar todas las reglas de las guías de Google. Algunas dependen de los valores, como el tamaño de las imágenes o el formato de precios y fechas; la Prueba de resultados enriquecidos de Google es la referencia. - Comprobar las propiedades de microdatos o RDFa. Estos solo se enumeran por tipo. - Confirmar que el marcado coincide con lo que muestra la página. Google lo exige, y solo una persona puede comparar ambas cosas. - Probar más páginas que la que introduces. ## Por qué es importante Los datos estructurados describen una página a las máquinas de forma estándar: esto es un producto con este precio, esto es un artículo de este autor, esta es la organización que hay detrás del sitio. Google los usa para entender las páginas y para mostrar resultados enriquecidos, como precios, valoraciones y rutas de navegación. Sus errores pasan desapercibidos. Un bloque JSON-LD roto se ve bien en la página, y una propiedad obligatoria que falta hace que un elemento deje de poder optar a su resultado enriquecido sin que nadie lo note. Search Console informa de parte de esto, pero solo de las páginas que Google ya ha rastreado. No es un atajo para aparecer en las respuestas de IA. Google afirma que AI Overviews y el Modo IA no necesitan ningún marcado especial de schema.org. Lo que cuenta es que el marcado sea válido y coincida con lo que muestra la página. ## Cómo interpretar los resultados - JSON válido o no se puede leer: Si el bloque se puede analizar. Un bloque que no se puede leer se ignora por completo, contenga lo que contenga. - Faltan propiedades obligatorias: El elemento no puede obtener su resultado enriquecido hasta que se añadan, y Search Console lo mostrará como no válido. - Propiedades recomendadas que añadir: El elemento puede optar al resultado; estas propiedades pueden hacerlo más completo. Añade solo valores que sean verdaderos y que se muestren en la página. - Completo: Las propiedades obligatorias y recomendadas están presentes. Aun así, sus valores tienen que ser correctos. - Sin comprobaciones de resultados enriquecidos: Un tipo válido, como WebPage o ImageObject, para el que Google no tiene ningún resultado enriquecido con propiedades obligatorias. - Google ya no muestra este resultado enriquecido: FAQ (desde el 7 de mayo de 2026) y How-to (desde septiembre de 2023). Mantener el marcado no causa ningún perjuicio. - a / b: Cualquiera de las dos propiedades cumple el requisito, por ejemplo offers / review / aggregateRating en un producto. ## Cómo corregir los problemas más habituales - Una coma final o unas comillas sin escapar: Son los errores de sintaxis más habituales. Pega el bloque en un validador de JSON para encontrar la posición, y escapa con una barra invertida las comillas dobles que haya dentro de los valores de texto. - Product sin offers, review ni valoración: El fragmento de producto de Google necesita un name más offers, review o aggregateRating. Las plataformas de tiendas online suelen generar offers con el precio y la disponibilidad; si la tuya no lo hace, revisa el tema o tu app de SEO. - Una valoración sin recuento: aggregateRating necesita ratingValue más ratingCount o reviewCount. Marca solo las valoraciones que los visitantes pueden ver en la página: las directrices de Google no permiten marcar contenido que no es visible. - Dos plugins, dos conjuntos de marcado: Los temas, los plugins de SEO y las apps pueden añadir cada uno sus propios datos Product u Organization. Los duplicados con valores distintos no ayudan a nadie: quédate con una sola fuente y desactiva las demás. - Elementos de la ruta de navegación sin dirección: Cada ListItem necesita una URL en item (salvo el último, que puede ser la página actual) y un name, y la lista necesita al menos dos elementos. - Nombre del sitio y organización en la página de inicio: Añade WebSite con name y url en la página de inicio para indicar a Google el nombre de tu sitio, y Organization con url, logo y enlaces sameAs a tus perfiles oficiales. ## Preguntas frecuentes ### ¿Qué es JSON-LD? Una forma de escribir datos estructurados como un objeto JSON dentro de un elemento script, separado del HTML visible. Google lo recomienda cuando tu configuración lo permite, ya que es el formato más fácil de añadir y mantener. ### ¿Por qué no veo resultados enriquecidos después de añadir el marcado? Google tiene que volver a rastrear la página, e incluso entonces decide en cada búsqueda si muestra un resultado enriquecido. Google no garantiza ninguno, ni siquiera para un marcado que supera sus pruebas. ### ¿Los datos estructurados mejoran el posicionamiento? La documentación de Google describe los datos estructurados como una forma de entender el contenido y de habilitar resultados enriquecidos, no como un factor de posicionamiento. Los resultados enriquecidos pueden hacer que un resultado sea más visible. ### ¿Sigue valiendo la pena añadir marcado FAQ? No para los resultados enriquecidos de Google: Google dejó de mostrarlos el 7 de mayo de 2026. El marcado sigue siendo schema.org válido, así que no hace falta quitarlo, pero no lo añadas esperando un resultado enriquecido. ### ¿Necesito marcado schema para aparecer en AI Overviews o en ChatGPT? Google afirma que AI Overviews y el Modo IA no necesitan ningún marcado especial de schema.org. Otros servicios de IA no publican requisitos. Un contenido claro con un marcado válido y preciso es la opción segura. ### ¿En qué se diferencia de la Prueba de resultados enriquecidos de Google? La Prueba de resultados enriquecidos es la referencia de Google y también comprueba los valores. Este validador enumera todos los elementos de la página en un lenguaje sencillo, muestra lo que le falta a cada uno y enlaza a la guía correspondiente. ## Fuentes - [Google Search Central: introducción al marcado de datos estructurados](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) - [Google Search Central: directrices generales sobre datos estructurados](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) - [Google Search Central: galería de datos estructurados en la Búsqueda](https://developers.google.com/search/docs/appearance/structured-data/search-gallery) - [Google Search Central: funciones de IA y tu sitio web](https://developers.google.com/search/docs/appearance/ai-features) - [Google Search Central: últimas actualizaciones de la documentación](https://developers.google.com/search/updates) - [Google: Prueba de resultados enriquecidos](https://search.google.com/test/rich-results) - [Schema.org: Schema Markup Validator](https://validator.schema.org/)