Validador de Marcado de Esquema

Siguiente

Los datos estructurados que casi validan son datos estructurados que fallan en silencio al producir un resultado enriquecido. Pega aquí tu bloque de JSON-LD y este validador confirma dos cosas al instante: que se analiza como JSON válido y que incluye lo esencial que necesita cualquier elemento de Schema.org: un @context, un @type y un name o headline. Piénsalo como la comprobación estructural rápida que haces antes de la Prueba de Resultados Enriquecidos, más lenta: detecta el corchete roto o el tipo que falta en segundos.

Cómo comprobar tu marcado de esquema

  1. 1

    Pega tu JSON-LD

    Inserta el bloque `<script type="application/ld+json">` completo o solo el objeto JSON que contiene: cualquier etiqueta script se elimina automáticamente.

  2. 2

    Ejecuta la comprobación

    El validador analiza el JSON y, si no se puede analizar, te señala el error de sintaxis exacto que debes corregir.

  3. 3

    Lee el resultado

    Confirma que las claves esenciales están presentes (`@context`, `@type` y un `name` o `headline`) o enumera exactamente cuáles faltan.

  4. 4

    Corrige y vuelve a comprobar

    Corrige el fragmento y vuelve a ejecutarlo hasta que salga limpio; luego llévalo a la Prueba de Resultados Enriquecidos de Google para las reglas específicas de cada tipo.

Errores comunes de validación y cómo solucionarlos

Cuando llevas tu marcado a un validador completo como la Prueba de Resultados Enriquecidos de Google, la mayoría de los fallos provienen de la misma lista corta de errores. Aprender a detectarlos reduce drásticamente el tiempo de depuración.

Infractores frecuentes

Mensaje de error Qué significa Cómo solucionarlo
Campo “image” faltante Campo requerido omitido Agrega al menos una URL de imagen (absoluta)
“datePublished” no es una fecha válida Formato incorrecto Usa ISO 8601: 2026-04-18 o con hora+offset
Tipo desconocido “Offers” Mayúsculas incorrectas Usa Offer (singular) dentro de un array offers
Campo requerido “price” faltante Producto sin precio Agrega price y priceCurrency en las ofertas
El valor de “author” es una cadena Debe ser un objeto Person/Organization Envuélvelo como { "@type": "Person", "name": "..." }
@id duplicado Mismo identificador en dos nodos Usa un @id único por entidad
reviewCount de 0 con aggregateRating El fragmento de estrellas requiere al menos 1 reseña Elimina la calificación o espera a tener reseñas
URL “/” (relativa) Los analizadores requieren URLs absolutas Usa la URL completa https://example.com/path

Advertencias vs errores

  • Los errores significan que el resultado enriquecido no es elegible. Corrígelos primero.
  • Las advertencias significan que es elegible, pero falta una propiedad que desbloquearía un fragmento más grande (por ejemplo, agregar brand y sku a un Producto).

Consejos para un marcado confiable

  • Comprueba la estructura antes de la validación profunda. Corregir aquí un corchete roto o un @type que falta te ahorra un viaje de ida y vuelta por las herramientas específicas de cada tipo, más lentas.
  • Mantén el marcado en sincronía con el contenido. Actualizar el título de la página sin actualizar el headline es la forma más rápida de que te marquen por incoherencia.
  • Prefiere JSON-LD por mantenibilidad: un solo bloque es más fácil de comprobar que propiedades dispersas por el HTML.
  • Monitorea Search Console. Google registra errores y mejoras de datos estructurados por tipo; revísalo mensualmente.

Preguntas frecuentes

No: significa que tu JSON-LD está bien formado y lleva las claves esenciales. Un resultado enriquecido también necesita las propiedades requeridas específicas del tipo, contenido que coincida de verdad con el marcado y los umbrales de calidad de Google. Usa esto para corregir lo básico rápido y luego confirma la elegibilidad en la Prueba de Resultados Enriquecidos de Google.

Esta es una comprobación estructural ligera: confirma que el JSON se analiza y que @context, @type y un name o headline están presentes. La prueba de Google va más allá y valida las propiedades requeridas de cada tipo elegible. Ejecuta esta primero para eliminar los fallos evidentes y luego la de Google para las reglas específicas de cada tipo.

Sí: pega el bloque <script type="application/ld+json">…</script> completo o solo el objeto JSON que contiene. Las etiquetas script que lo envuelven se eliminan antes de analizar. Valida un bloque a la vez.

No. El fragmento se envía a nuestro servidor solo para ejecutar la comprobación y se descarta justo después; nada de lo que pegas se guarda.

Herramientas relacionadas

Herramienta disponible en otros idiomas