Cómo validar tu schema markup: errores comunes y cómo corregirlos

Validar el schema markup consiste en comprobar tres cosas: que el código no tenga errores de sintaxis, que cumpla el vocabulario de Schema.org y que reúna los requisitos de Google para mostrar resultados enriquecidos.

Un marcado puede pasar la primera prueba y fallar la tercera. Por eso conviene usar más de una herramienta y revisar el resultado en Search Console después de publicar.

Última actualización: octubre de 2026.

Qué significa que un schema markup sea válido

Un marcado es válido cuando un parser lo entiende y es correcto respecto a Schema.org, pero eso no basta para ganar resultados enriquecidos. Google exige que el marcado represente fielmente el contenido de la página, que no describa información invisible para el lector y que incluya todas las propiedades obligatorias de cada tipo. Si falta alguna, la página no es elegible para el resultado enriquecido.

Estas condiciones están recogidas en las directrices generales de datos estructurados de Google. Si quieres entender cómo encajan los datos estructurados dentro del resto del trabajo técnico, lo explicamos en nuestra guía de SEO técnico.

Hay que distinguir tres niveles:

Nivel	Qué comprueba	Herramienta
Sintaxis	JSON bien formado, comillas y comas correctas	Cualquier validador JSON, Schema Markup Validator
Vocabulario	Tipos y propiedades que existen en Schema.org	Schema Markup Validator
Elegibilidad en Google	Propiedades obligatorias y recomendadas por tipo	Rich Results Test, Search Console

Además, ni siquiera un marcado perfecto garantiza que Google muestre un resultado enriquecido. Se trata de ser elegible, no de tener un derecho adquirido.

Herramientas para validar schema markup

Necesitas tres herramientas y cada una responde a una pregunta distinta.

Schema Markup Validator. Es el sucesor del antiguo Structured Data Testing Tool. Comprueba la sintaxis y el vocabulario frente a Schema.org, sin atender a funciones concretas de ningún buscador. Es útil cuando quieres que el marcado sea correcto más allá de Google.

Rich Results Test. Evalúa la compatibilidad con las funciones de búsqueda de Google, por lo que puede mostrar errores que el validador de Schema.org no detecta. Si el primero dice «todo correcto» y este marca fallos, tu marcado es válido pero no cumple los requisitos de Google.

Search Console. Los informes de estado de resultados enriquecidos sirven para vigilar el marcado ya desplegado, porque los fallos suelen aparecer después por plantillas o problemas de servidor, no al escribir el código. La inspección de URL añade una comprobación en vivo de lo que Google ve.

Google indica que el Rich Results Test y la inspección de URL detectan la mayoría de los errores técnicos.

Método de validación en 5 pasos

1. Valida la sintaxis y el vocabulario. Pega la URL o el código en el Schema Markup Validator y corrige primero los errores de formato.
2. Pasa la URL por el Rich Results Test. Distingue entre errores (bloquean la elegibilidad) y advertencias (propiedades recomendadas que mejoran el marcado pero no lo invalidan).
3. Compara el marcado con la página. Cada dato del JSON-LD (precio, autor, fecha, valoraciones) debe aparecer visible para el usuario.
4. Haz una inspección de URL en vivo en Search Console para confirmar que Google renderiza el marcado tal como lo publicaste.
5. Monitoriza tras el despliegue. Revisa los informes de resultados enriquecidos después de cada cambio de plantilla, plugin o tema.

Haz estos pasos en un entorno de pruebas antes de publicar y repítelos al menos una vez al trimestre en las plantillas más importantes.

Los 9 errores más comunes y cómo corregirlos

1. JSON-LD con errores de sintaxis

Síntoma: el marcado no se detecta o aparece como no analizable. Las causas habituales son comillas tipográficas copiadas desde un editor de texto, comas sobrantes al final de un bloque o llaves sin cerrar.

Corrección: usa siempre comillas rectas y valida el bloque con un parser JSON antes de pegarlo.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Título del artículo",
  "datePublished": "2026-10-08"
}

2. Faltan propiedades obligatorias

Cada tipo tiene sus propias propiedades obligatorias. Si falta alguna, el elemento no es elegible para resultados enriquecidos.

Corrección: consulta la documentación de Google del tipo concreto y completa lo que el Rich Results Test marque como error.

3. El marcado no coincide con el contenido visible

Es el error más grave por sus consecuencias. Google prohíbe marcar contenido que el lector no puede ver en la página. Marcar datos que no aparecen puede derivar en una acción manual por datos estructurados, que deja la página sin elegibilidad para resultados enriquecidos.

Corrección: elimina del JSON-LD cualquier dato que la página no muestre.

4. Fechas y precios con formato incorrecto

Las fechas deben seguir el formato ISO 8601 (2026-10-08 o 2026-10-08T09:30:00+02:00). Los precios van como número sin símbolo y con la moneda en otra propiedad.

"offers": {
  "@type": "Offer",
  "price": "49.90",
  "priceCurrency": "EUR"
}

5. URLs relativas o imágenes inaccesibles

Las propiedades image, url o logo deben usar URLs absolutas y accesibles para el rastreador. Una imagen bloqueada por robots.txt o una ruta relativa como /img/logo.png invalidan la propiedad.

6. Marcado duplicado o contradictorio

Es habitual en WordPress: el tema, Yoast o Rank Math y un plugin de reseñas generan cada uno su bloque y el resultado es contradictorio (dos Organization, tres Article).

Corrección: deja un único generador por tipo y desactiva el resto. Cuenta los bloques en el código fuente buscando application/ld+json.

7. Tipo equivocado o propiedades inventadas

Marcar un servicio como Product o escribir propiedades que no existen en Schema.org no aporta ningún beneficio y confunde al validador.

Corrección: elige el tipo más específico que describa la página (Service, LocalBusiness, Article) y usa solo propiedades que figuren en schema.org.

8. Reseñas y valoraciones mal planteadas

Las valoraciones deben representar opiniones reales visibles en la página. Un ratingValue fuera de rango o un aggregateRating sin reseñas visibles incumple las directrices. Las reseñas que escribes tú sobre tu propio negocio no son elegibles para estrellas en los resultados de Google.

9. Confundir «válido» con «se mostrará»

Que el marcado pase el test no significa que aparezca el resultado enriquecido. No es un fallo técnico, pero genera expectativas erróneas con los clientes y es el tema del siguiente apartado.

Lo que debes saber de FAQ y HowTo en 2026

El marcado FAQPage sigue siendo válido, pero ya no produce resultados enriquecidos en Google. Google retiró por completo los resultados enriquecidos de FAQ el 7 de mayo de 2026. En junio de 2026 se eliminaron el informe de FAQ en Search Console y el soporte en el Rich Results Test, y en agosto de 2026 los datos de FAQ en la API de Search Console.

Si tu validador antiguo o tu informe de Search Console daba por buena una FAQ, esa comprobación ya no existe en el Rich Results Test. El marcado sigue siendo un tipo válido de Schema.org y Google ha dicho que los datos estructurados sin uso no perjudican a la página. Puedes dejarlo si describe una sección que existe de verdad.

Los resultados enriquecidos de HowTo corrieron la misma suerte antes: se retiraron de móvil en agosto de 2023 y de escritorio en septiembre de 2023, según el anuncio de cambios en resultados enriquecidos de FAQ y HowTo de Google.

La lección práctica es no basar tu estrategia en un único resultado enriquecido. Google ha ido retirando varios de forma progresiva, así que prioriza el marcado que describe bien tu entidad (organización, artículo, producto, negocio local) y evalúa cada tipo según lo que Google admite hoy.

Preguntas frecuentes

¿Cuál es la mejor herramienta para validar schema markup?

Ninguna lo cubre todo. Usa el Schema Markup Validator para la sintaxis y el vocabulario, el Rich Results Test para la elegibilidad en Google y Search Console para el seguimiento una vez publicado.

¿Por qué el Schema Markup Validator no da errores y el Rich Results Test sí?

Porque miden cosas distintas. El primero comprueba el cumplimiento de Schema.org y el segundo los requisitos específicos de Google. Si falla el segundo, tu marcado es válido pero no elegible para ese resultado enriquecido.

¿Los errores de schema pueden penalizar mi web?

Los errores técnicos hacen que el marcado se ignore. La excepción es marcar contenido no visible o engañoso, que puede acarrear una acción manual por datos estructurados.

¿Debo borrar el schema FAQ de mis páginas?

No es necesario. Google ya no lo muestra como resultado enriquecido, pero sigue siendo un tipo válido. Solo elimínalo si describe contenido que ya no existe en la página.

Conclusión. Valida el marcado en tres niveles (sintaxis, vocabulario y elegibilidad en Google), contrasta cada dato con lo que ve el usuario y revisa Search Console después de cada cambio de plantilla.