Vutral
Cómo usar esta herramienta

Validador de Schema Markup y Datos JSON-LD

Cómo usar el validador de schema markup

Volver a la herramienta

Entra una página; cada bloque JSON-LD de su HTML original se analiza y se contrasta con el vocabulario de Schema.org.

  1. 01

    Introduce la página a comprobar

    Una página por ejecución: los datos estructurados pertenecen a una página concreta, y una pila de árboles de entidades no es algo que se lea en paralelo. Normalizar URL sigue importando: ponlo en Solo dominio y estarás leyendo el marcado de la portada, no el de la página que pegaste.

  2. 02

    Ejecuta la comprobación sobre el HTML sin procesar

    La herramienta descarga la página y analiza el HTML que recibe. No ejecuta JavaScript, así que el marcado que un script inyecta después de la carga no está ahí para encontrarlo. Por eso un resultado vacío dice "no encontrado en el HTML original" y no "esta página no tiene schema".

  3. 03

    Lee la impresión JSON de los datos declarados

    El resultado es un documento JSON con líneas numeradas: los datos estructurados tal como se leyeron, no el marcado que escribiste. Un elemento referenciado por @id se rellena donde se usa. Una línea con un problema se tiñe, con un icono para errores y otro para avisos. Bajo la impresión, un chip por tipo declarado resalta cada bloque de ese tipo.

  4. 04

    Sigue la lista hasta la línea exacta y exporta

    Bajo la impresión están los dos recuentos y una entrada por problema, ordenadas por número de línea. Cada entrada enlaza con su propia línea en la impresión, así que una página con treinta problemas sigue siendo recorrible. Copiar y Exportar en la fila sobre la impresión te entregan la impresión misma: la descarga es un archivo .json que puedes pegar de vuelta directamente.

Cómo leer el informe de datos estructurados JSON-LD

La lista responde a dos preguntas: qué declara esta página, y qué partes rechazaría un parser. Los campos obligatorios y la elegibilidad para resultados enriquecidos no se juzgan aquí; el buscador los decide por cada tipo de resultado enriquecido.

Elementos de la impresión

@type
El tipo Schema.org del elemento, impreso como su primera línea, y la línea donde se marca un tipo inválido. Un elemento que solo es una referencia no tiene línea @type: la página no declaró ninguno y la impresión no inventa nada.
@id
Lo que distingue dos elementos del mismo tipo, impreso justo después de @type. Un elemento referenciado por @id se rellena donde se usa, sin repetirse en el nivel superior, así que la impresión puede ser más corta que el marcado.
Errores
Marcado que un analizador rechazaría o ignoraría: un tipo o una propiedad que no está en el vocabulario, un valor del tipo equivocado, un bloque que no es JSON válido.
Avisos
Marcado válido que probablemente no es lo que querías decir — casi siempre una propiedad que existe pero no está definida para este tipo. Schema.org los llama expectativas, no reglas, así que aquí nunca se convierten en errores.

Referencia de mensajes

El tipo no está en el vocabulario
El @type no existe en Schema.org: normalmente una errata o un nombre inventado para el sitio. Un elemento sin ningún @type se informa igual, porque un analizador no puede hacer nada con ninguno de los dos.
La propiedad no está en el vocabulario
El nombre de la propiedad no existe en ninguna parte de Schema.org, así que nada puede leerlo. Esto es un error: el valor se descarta diga lo que diga.
La propiedad no es válida para este tipo
La propiedad existe, solo que no en este tipo — cookTime en un Article, por ejemplo. Solo un aviso: Schema.org trata el tipo al que pertenece una propiedad como orientación, y los consumidores la leen igual.
El valor no coincide con el tipo esperado
La propiedad existe y va aquí, pero el valor es de otra clase — una cadena simple donde se esperaba una fecha o un elemento anidado.
Este bloque no es JSON válido
Se reporta encima de la lista y no dentro de un bloque, porque un bloque que no se puede parsear no tiene elementos a los que adjuntar nada. Todo lo que sigue al error de sintaxis queda sin leer; una coma de más puede ocultar el resto del marcado.
Sin @context apuntando a schema.org
Se reporta aquí a propósito aunque el validador de referencia calle al respecto. Sin @context los nombres de dentro son solo palabras, así que nada en el bloque pudo comprobarse, y un informe limpio sobre un bloque sin comprobar es la peor respuesta posible.