Guía

¿Cómo validar datos estructurados con un validador de schema?

Por Equipo Laurank · Publicado el · Actualizado el

Laurank es una empresa de AEO en español: ayudamos a que ChatGPT, Gemini, Perplexity y los AI Overviews de Google citen a tu marca, empezando por entender por qué hoy no lo hacen. Conoce a Laurank.

Puntos clave

  • La prueba de resultados enriquecidos comprueba si tu marcado puede dar resultados enriquecidos de Google; el validador de Schema.org valida el vocabulario sin advertencias específicas de Google.
  • Un error crítico impide el resultado enriquecido; una advertencia (problema no crítico) no lo impide, pero Google recomienda corregirla.
  • Los informes de Search Console muestran una muestra de elementos de las páginas indexadas, no todo el sitio.
  • Si el fallo viene de la plantilla, corregirla arregla todas las páginas afectadas; luego se pulsa Validar corrección.
  • Que el marcado pase la prueba no garantiza que Google muestre el resultado enriquecido, y Google dice que no hace falta schema especial para sus funciones de IA.

¿Cómo valido los datos estructurados de mi sitio?

Pega la URL o el código en la prueba de resultados enriquecidos de Google, corrige lo que marque y, cuando Google ya haya rastreado el sitio, revisa los informes de Mejoras en Search Console. Son dos niveles: la prueba revisa una página o un fragmento al momento; Search Console muestra lo que Google ya encontró en tu sitio.

La secuencia completa, de principio a fin:

  1. Escribe o genera el marcado (a mano o con tu plugin). Qué tipo poner no se explica aquí: está en datos estructurados para empresas.
  2. Pruébalo con la prueba de resultados enriquecidos, con la URL o pegando el código.
  3. Corrige primero los errores y después las advertencias, y vuelve a ejecutar la prueba hasta que el estado sea el esperado.
  4. Publica el cambio y comprueba la URL publicada con la herramienta de inspección de URLs de Search Console.
  5. Espera a que Google rastree y abre los informes de Mejoras para ver el estado de todo el sitio.
  6. Corrige el problema en la plantilla cuando afecte a muchas páginas.
  7. Pulsa Validar corrección en la página de detalles del problema y sigue el estado.

Lo que sigue explica cada paso con lo que dice la documentación de Google. El marcado en sí no es el objetivo: Google lo usa para entender la página y, cuando cumple los requisitos, para mostrar resultados enriquecidos.

¿Qué diferencia hay entre la prueba de resultados enriquecidos y el Schema Markup Validator?

La prueba de resultados enriquecidos es la herramienta oficial de Google para ver qué resultados enriquecidos puede generar tu página; el Validador de marcado de Schema.org valida todo el marcado basado en Schema.org sin mostrar advertencias específicas de funciones de Google. Google recomienda empezar por la primera.

La página de Google sobre cómo probar datos estructurados lo dice así: la prueba de resultados enriquecidos sirve “para ver qué resultados enriquecidos de Google se pueden generar a partir de tu página”, y el validador es para “probar datos estructurados de schema.org sin validar funciones específicas de Google”. El segundo vive ahora en validator.schema.org; la herramienta antigua de prueba de datos estructurados dejó de validar funciones de Google y cambió de nombre y de dominio.

Prueba de resultados enriquecidos Validador de marcado de Schema.org Search Console (informes de Mejoras) Inspección de URLs
Qué comprueba Si el marcado puede dar resultados enriquecidos de Google Que el marcado de Schema.org sea válido, sin reglas de Google Los datos estructurados que Google ya rastreó en tu sitio Una URL concreta: versión indexada o prueba en tiempo real
Qué necesitas URL accesible para cualquiera o código pegado URL o código Propiedad verificada y páginas indexadas Propiedad verificada
Advertencias de funciones de Google Sí No Sí (problemas no críticos) Sí, dentro de la sección de mejoras
Cuándo usarla Antes y después de publicar Para marcado de tipos que Google no convierte en resultado enriquecido Para ver el estado de todo el sitio y pedir la revisión Para confirmar qué vio Google en una página

La consecuencia práctica: si tu marcado pasa el validador de Schema.org pero la prueba de resultados enriquecidos no detecta ningún elemento, el vocabulario puede ser correcto y aun así no corresponder a una función de Google. No es un error tuyo; es que Google solo muestra resultados enriquecidos para los tipos que documenta.

¿Cómo uso la prueba de resultados enriquecidos paso a paso?

Abre la prueba, elige URL o Código, ejecuta la prueba y revisa el estado de la URL, el rastreo y los elementos detectados. Admite JSON-LD, RDFa y microdatos.

Según la documentación de la herramienta, así se ejecuta:

  1. Elige el modo. Con una URL, envía la dirección completa; la página debe ser accesible para cualquier usuario anónimo, así que los recursos protegidos por contraseña o cortafuegos no se pueden probar. Con código, selecciona Código en vez de URL y pega el fragmento; puedes editarlo y probarlo tantas veces como quieras.
  2. Elige el user-agent (opcional). El predeterminado es el de smartphones, que según Google es como navega la mayoría de los usuarios.
  3. Ejecuta la prueba y lee primero el estado de la URL.
  4. Despliega los errores y advertencias y haz clic en su descripción para abrir el explorador de código en el fragmento afectado.

El estado de la URL puede indicar, por ejemplo, que se detectaron elementos válidos, elementos válidos con advertencias, elementos no válidos, que no se detectó ningún elemento, que no se pudo rastrear la URL o que hay errores de sintaxis en los datos estructurados. Cada uno apunta a una acción distinta, que se resume en esta tabla de decisión.

Si la prueba dice… Qué significa Qué hacer
Elementos válidos Sin problemas graves detectados Publica; revisa en Search Console más adelante
Válidos con advertencias Puede mostrarse, hay mejoras posibles Revisa cada advertencia; corrige las que describan algo real de tu página
Elementos no válidos o “algunos no son válidos” Hay al menos un error crítico Corrige el campo marcado y vuelve a probar
Errores de sintaxis El JSON o el marcado está mal formado Revisa comas, llaves y comillas (ver más abajo)
No se ha detectado ningún elemento La página no tiene marcado que Google reconozca Comprueba que el script está en la página renderizada y que el tipo es uno que Google admite
No se ha podido rastrear la URL Google no puede acceder Revisa robots.txt, noindex, inicio de sesión o errores del servidor

Dos avisos de la propia documentación. Primero, la herramienta ignora los comentarios dentro de bloques JSON-LD, pero eso no cumple el estándar JSON-LD y pueden aparecer errores: quítalos antes de publicar. Segundo, la prueba visita la página como Google-InspectionTool, así que un robots.txt puede bloquearla; si la página tiene robots.txt o noindex que impide el rastreo, no se puede probar. Para entender esas reglas, mira qué es el SEO técnico.

¿Cuál es la diferencia entre un error y una advertencia?

Un error es un problema crítico que impide que el elemento aparezca como resultado enriquecido; una advertencia es un problema no crítico que no lo impide, pero que mejora el aspecto del resultado si se corrige. Search Console los separa en dos tablas.

Search Console lo define en su informe de resultados enriquecidos: un elemento válido “no tiene ningún problema grave y puede aparecer en Google como resultado enriquecido”, y uno no válido “tiene al menos un problema grave que impide que aparezca”. En la página de destino del informe verás la tabla “Por qué los elementos no son válidos” (críticos) y la tabla “Mejorar el aspecto de los elementos” (no críticos).

Error (crítico) Advertencia (no crítico)
Efecto El elemento no es válido y no se muestra como resultado enriquecido El elemento puede mostrarse; el resultado podría ser más completo
Ejemplo Falta una propiedad obligatoria Falta una propiedad recomendada
Prioridad Primero Después
Dónde se ve Prueba de resultados enriquecidos y tabla “Por qué los elementos no son válidos” Prueba de resultados enriquecidos y tabla “Mejorar el aspecto de los elementos”

Un elemento puede tener varios problemas a la vez, críticos y no críticos, y por eso el total de problemas puede superar la suma de elementos válidos e inválidos. Que el marcado sea válido tampoco garantiza que Google muestre el resultado: eso depende también de las directrices y de la propia página.

¿Cómo leer los informes de datos estructurados en Search Console?

Entra en Search Console, busca el informe de tu tipo de resultado enriquecido en el menú Mejoras (productos y fichas de comercio, en Shopping) y empieza por la tabla de errores. Solo aparece un informe por cada tipo de resultado enriquecido que Google haya encontrado en tu propiedad.

Según la descripción general del informe, cada informe tiene una página de destino con un gráfico de elementos válidos e inválidos y las dos tablas de problemas, y una página de detalles al hacer clic en un problema. Tres precisiones que cambian cómo lo lees:

  • Cuenta elementos, no páginas. Las cifras reflejan elementos de datos estructurados; una página puede tener varios.
  • Es una muestra. Google indica que los informes no muestran una lista completa de todos los elementos detectados, sino una muestra para evaluar la calidad. Para una URL que no aparece, usa la herramienta de inspección de URLs.
  • Solo hay informe si Google encontró un marcado válido de un tipo admitido. Si falta el informe de un tipo, hay una guía oficial para depurar datos estructurados que faltan.

La página de detalles de cada problema muestra el estado de validación, la fecha de primera detección, una lista de ejemplos y la fecha del último rastreo. Si ves un icono de inspección junto a una URL, abre la herramienta de inspección de URLs con el detalle de esa página. Para los pasos de rastreo e indexación, la pieza sobre cómo usar Search Console explica la herramienta en general.

Hay un segundo informe que conviene conocer. El informe de datos estructurados que no se pueden analizar solo existe si Google encontró marcado con un error grave de sintaxis; ahí no hay advertencias ni elementos válidos, solo errores críticos, y Google ni siquiera puede saber de qué tipo es el marcado. Es el primero que debes arreglar, porque al corregirlo pueden aparecer errores o advertencias que antes estaban ocultos.

¿Qué errores de datos estructurados son más comunes y cómo se corrigen?

Los más comunes son propiedades que faltan, valores con formato o tipo equivocado y JSON mal formado; cada mensaje de Search Console trae una corrección sugerida. La lista oficial de mensajes no es exhaustiva, y para cada tipo manda la documentación de esa función.

Estos mensajes salen de la página oficial de mensajes de error, con la acción que Google sugiere.

Mensaje que verás Qué hacer
Falta el campo “nombre de la propiedad” Añade la propiedad que falta; puede ocurrir también si el valor es una cadena vacía
La URL del campo no es válida Sustituye por una URL válida y completa
Código de moneda ISO 4217 no válido Usa un código ISO 4217 válido para la moneda del precio, no un símbolo ni el nombre de la moneda
La fecha o la hora no están en formato ISO 8601 Usa el formato ISO 8601
En la propiedad de fecha y hora falta la zona horaria Añade la zona horaria al valor
El valor del campo debe ser positivo Usa un número positivo
El campo está duplicado Deja un solo valor definido para la propiedad
No se reconoce el campo Revisa que el nombre sea válido y no tenga errores de ortografía
No se ha proporcionado ningún identificador internacional (GTIN, MPN o ISBN) En un producto, añade al menos uno de los identificadores que lista Google
El esquema data-vocabulary.org está obsoleto Actualiza al vocabulario de schema.org

Un caso que conviene mirar aparte es el del dato que cambia por mercado. En una tienda de México, Colombia o Chile, el precio y la moneda del marcado deben coincidir con los de la ficha visible: si el mensaje es “Código de moneda ISO 4217 no válido”, revisa que hayas escrito el código y no un símbolo. Qué propiedades lleva cada tipo y las directrices sobre contenido que el usuario no ve están en la pieza sobre datos estructurados para empresas; aquí solo se cubre cómo detectarlas y cerrarlas.

¿Cómo corrijo errores de sintaxis en el JSON-LD?

Valida el JSON con la prueba de resultados enriquecidos; si no localizas el fallo, empieza desde un objeto vacío y vuelve a añadir tu código por secciones hasta que aparezca el error. Es el método que recomienda Google para el informe de datos que no se pueden analizar.

Los errores de ese informe son casi siempre de puntuación. Google lista, entre otros, “El documento JSON no es válido”, “Falta un carácter ‘:’”, “Faltan caracteres ‘,’ o ‘}’” y secuencias de escape incorrectas (una barra invertida sin sentido dentro de un texto). Ejemplo ilustrativo con datos ficticios, donde falta una coma tras "name":

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Estudio Contable Andes"
  "url": "https://ejemplo.com"
}

Aquí la prueba marca un error de análisis porque tras el valor de name falta una coma. Con la coma puesta, el mismo bloque se analiza y Google puede empezar a evaluar propiedades que antes no veía. Otras causas habituales, todas de la lista oficial: comillas dentro de un texto sin escapar, una propiedad escrita dos veces (por ejemplo, dos @context) y un valor de otro tipo del esperado, como texto donde Google espera un número.

Si usas un plugin o un gestor de contenidos, no edites el JSON a mano en cada página: corrige el ajuste del plugin o la plantilla, para que el cambio llegue a todas las URL.

¿Cómo uso Validar corrección en Search Console?

Corrige el problema en el sitio, comprueba una página con “Probar URL publicada” y, desde la página de detalles del problema, pulsa Validar corrección. Google revisa una muestra primero y, si pasa, valida el resto.

El flujo oficial de corregir problemas de datos estructurados, ordenado:

  1. Elige un problema en la tabla “Por qué los elementos no son válidos” y abre la lista de páginas afectadas.
  2. Resuelve ese problema en todas las URL afectadas antes de pasar a otro. Si nace de un error de plantilla, corregir la plantilla arregla todas las páginas asociadas.
  3. Publica los cambios y confirma que las páginas son rastreables, sin bloqueo de robots.txt ni noindex.
  4. Comprueba páginas concretas con “Probar URL publicada” en la herramienta de inspección de URLs.
  5. Pulsa Validar corrección en la página de detalles del problema.

La validación comprueba de inmediato una muestra de páginas. Si el error persiste, se detiene; si no, las URL afectadas se ponen en cola para volver a rastrearse y el progreso queda en el historial. Google indica que puede tardar dos semanas o más, según la frecuencia de rastreo, y avisa por correo del resultado.

Estado de validación Qué significa Qué hacer
No iniciado No hay intentos previos Revisa ejemplos reales, corrige y pulsa Validar corrección
Iniciada La validación está en curso Espera; Google avisa del progreso
Tiene buena pinta Las instancias comprobadas pasaron Sigue monitorizando hasta que termine
Correcto Se resolvieron todos los casos conocidos Nada más
Error Algunas URL siguen con el problema Corrige lo que queda y reinicia la validación
N/A Se solucionó sin necesidad de validar Nada más

Si la validación falla, espera a que termine el ciclo actual antes de iniciar otro; la nueva validación cubre las URL fallidas o pendientes y las instancias nuevas. Otro detalle: un problema permanece activo hasta que pasan 90 días sin nuevas instancias, y si reaparece dentro de ese plazo conserva la fecha original de detección. Google puede además detectar tus correcciones en el rastreo habitual y actualizar el recuento sin que pulses el botón.

Google sí recomienda validar: confirma que las soluciones funcionan, agiliza la revisión por parte de Google, envía avisos por correo y deja un registro del avance por URL. No hay botón de “corregir este problema” porque los datos estructurados están en tu sitio y no en los servidores de Google.

¿Por qué Search Console no muestra mis datos estructurados o los muestra con retraso?

Lo más común es que la página no esté indexada, que Google aún no la haya rastreado, que haya un error de sintaxis o que algo bloquee el acceso. Google lista estas causas en su guía de datos estructurados que faltan.

Según la guía oficial para depurar datos que faltan, considera estas posibilidades:

  • El informe es una muestra de tus páginas.
  • Errores de sintaxis: el marcado no se puede analizar y aparece en el informe de datos que no se pueden analizar, si está disponible.
  • Páginas no indexadas: solo las indexadas salen en los informes. Si tu página no está en el índice, el problema es previo: mira qué es la indexación y por qué Google no indexa mi página.
  • Retrasos de rastreo: el marcado nuevo puede tardar en aparecer; solicitar un nuevo rastreo ayuda, pero lleva tiempo.
  • Acceso: inicio de sesión, robots.txt o noindex impiden que se muestre.

Si el número de elementos baja de golpe, los factores que cita Google son menos páginas indexadas, errores críticos en páginas antes válidas y cambios en el tamaño de la muestra. El orden de comprobación que propone es: estado de indexación con la inspección de URLs, validar el marcado con la prueba de resultados enriquecidos y confirmar que no hay barreras técnicas. Criterio de Laurank: si la bajada coincide con un cambio de plantilla o una actualización de plugin, revisa primero qué JSON-LD genera ahora.

Ejemplo ilustrativo con datos ficticios: una tienda tiene 120 fichas de producto con el mismo plugin. El informe de fragmentos de producto marca un error crítico en 118 elementos por una propiedad vacía. Al ver que la propiedad sale de una sola plantilla, se corrige el ajuste una vez, se prueba una ficha con “Probar URL publicada” y se pulsa Validar corrección. Las dos fichas restantes tenían otro problema, y por eso ese estado quedó en “Error” hasta que se corrigieron también.

¿Qué no te dice una validación sobre IA y posicionamiento?

Validar solo te dice si el marcado está bien formado y es apto para resultados enriquecidos de Google; no te dice que aparecerás en ChatGPT, en Gemini ni en los resúmenes de IA. Google afirma que no hace falta schema especial para sus funciones de IA.

La página de Google sobre sus funciones de IA indica que para aparecer en ellas no es necesario crear archivos legibles por máquinas ni archivos de texto de IA, y añade: “Tampoco es necesario añadir datos estructurados especiales de schema.org.” También recomienda comprobar que los datos estructurados coincidan con el texto visible de la página. Eso es lo que hace falta: marcado correcto y fiel a la página, no un marcado extra para la IA.

Sobre otros asistentes (ChatGPT, Claude, Perplexity), no encontramos en su documentación pública ninguna indicación de que usen schema para elegir las fuentes que citan; por eso en Laurank no presentamos el schema como palanca de citas. La validación es higiene técnica: evita errores que bloquean resultados enriquecidos y problemas de interpretación. Para lo que sí está documentado en IA, empieza por cómo aparecer en los AI Overviews de Google y revisa cómo saber si mi sitio es legible para la IA.

Si el marcado está en páginas que dan error 404 o que tienen versiones duplicadas (ver etiqueta canonical), arregla eso primero; la auditoría SEO los ordena.

¿Qué errores se cometen al validar datos estructurados?

Los errores más frecuentes son validar solo con una herramienta, dar por bueno lo que pasa la prueba y corregir página por página lo que es un fallo de plantilla. Todos son evitables con el flujo anterior.

  • Usar solo el validador de Schema.org y asumir que Google mostrará un resultado enriquecido. El validador no incluye las reglas de Google.
  • Probar solo con código pegado y no con la URL publicada: el código puede estar bien y el sitio entregar otra cosa.
  • Corregir sin publicar y pulsar Validar corrección antes de que el cambio esté en vivo.
  • Corregir página por página cuando el error es de plantilla.
  • Ignorar el informe de sintaxis, que oculta otros problemas hasta que se arregla.
  • Rellenar propiedades con datos inventados para quitar una advertencia. El marcado debe describir lo que el visitante ve.
  • Esperar un efecto inmediato. Pasar la prueba no asegura que el resultado aparezca, y la validación en Search Console puede tardar semanas.

¿Cómo ayuda Laurank?

Laurank no valida tu schema: si tras revisar el marcado tu empresa sigue sin aparecer en las respuestas de la IA, el diagnóstico explica por qué la IA no te cita. Lo que se mira son bots que no leen el sitio, preguntas sin responder, competencia instalada y marca no reconocida; el marcado es una parte menor.

Las promesas de citas no existen aquí: depende de tu sector y de tu competencia. Si quieres que revisemos tu caso, escríbenos por WhatsApp con el nombre de tu marca y tu sector, y mira el diagnóstico para ver qué incluye.

Preguntas frecuentes

¿Cuál es el mejor validador de schema?

No hay uno mejor para todo: sirven para cosas distintas. Si quieres saber si Google puede mostrar un resultado enriquecido, usa la prueba de resultados enriquecidos. Si solo quieres comprobar que el marcado de Schema.org está bien formado, usa el validador de Schema.org, que no muestra advertencias específicas de funciones de Google.

¿Puedo validar datos estructurados de una página que aún no está publicada?

Sí, con el código. La prueba de resultados enriquecidos permite elegir Código en lugar de URL, pegar el fragmento y ejecutar la prueba tantas veces como quieras. Si usas una URL, la página tiene que ser accesible para cualquier usuario anónimo, sin contraseña ni cortafuegos.

¿Por qué Search Console no muestra mis datos estructurados si la prueba dice que son válidos?

Lo más probable es que Google no haya rastreado todavía la página, que no esté indexada o que algo bloquee el acceso (robots.txt, noindex o inicio de sesión). Además, los informes muestran una muestra de elementos, no una lista completa. Inspecciona la URL en Search Console para ver qué detectó Google en la versión indexada.

¿Cuánto tarda Google en validar una corrección?

Google indica que la validación puede tardar dos semanas o más, según la frecuencia de rastreo. Primero comprueba una muestra de páginas; si el error persiste, la validación se detiene, y si no, continúa con el resto. Aunque no pulses el botón, Google puede detectar la corrección en un rastreo normal.

¿Hay que corregir las advertencias o solo los errores?

Los errores críticos primero, porque impiden el resultado enriquecido. Para las advertencias, Google recomienda corregir también los problemas no críticos que marque la herramienta, aunque no sean necesarios para que el resultado se muestre. Criterio de Laurank: corrígelas cuando la propiedad describa algo real de tu página; no inventes datos para silenciar una advertencia.

¿Validar el schema ayuda a que me citen en ChatGPT o en los resúmenes de IA de Google?

Google dice que no es necesario añadir datos estructurados especiales de schema.org para aparecer en sus funciones de IA. Validar sirve para que el marcado se lea bien y sea apto para resultados enriquecidos de Google, no como palanca de citas. Los demás asistentes no documentan el uso de schema para elegir fuentes en las páginas que consultamos.

Fuentes

¿Quieres que la IA cite a tu marca?

Cuéntanos tu caso por WhatsApp y te decimos por dónde empezar.

Escríbenos por WhatsApp

Artículos relacionados

SEO técnico ·

¿Qué datos estructurados debe tener el sitio de una empresa?

Una empresa debe tener datos estructurados Organization en su página principal y, según su negocio, LocalBusiness (con dirección), Product (en fichas de producto) y Article (en el blog). Se añaden en JSON-LD y se validan con la prueba de resultados enriquecidos. Google dice que no hacen falta para sus funciones de IA.

Medición y rastreo en IA ·

¿Cómo usar Search Console para medir el SEO de tu sitio?

Google Search Console es un servicio gratuito de Google para supervisar cómo aparece tu sitio en la Búsqueda de Google. Se usa verificando una propiedad y leyendo el informe de Rendimiento: clics, impresiones, CTR y posición. Las funciones de IA de Google van incluidas ahí, y Search Console tiene además informes de rendimiento de IA generativa; ChatGPT no.

SEO técnico ·

¿Qué es el SEO técnico y qué revisar primero en tu sitio?

El SEO técnico es el conjunto de ajustes que permiten a Google y a otros bots rastrear, indexar y renderizar tus páginas. Revisa en este orden: que robots.txt y el firewall no bloqueen, que las páginas estén indexadas, que el contenido se vea sin depender de JavaScript y, al final, la velocidad.