Use la Prueba de resultados enriquecidos (Rich Results Test) para ver si Google puede leer su marcado para una función compatible de Google Search. Use el Schema Markup Validator para comprobar si el marcado usa correctamente los tipos y propiedades de Schema.org.

La propia documentación de Google recomienda esta división. Pase su código primero por el validador y, si el tipo tiene una función vigente de Google, después por la Prueba de resultados enriquecidos. Luego revise la página publicada en Search Console y en las demás herramientas de búsqueda que le importen.

Un resultado aprobado significa que el marcado puede analizarse o que podría ser elegible. No garantiza el rastreo, la indexación, el posicionamiento, un resultado enriquecido ni una cita en una respuesta de IA.

Puntos clave

  1. Elija según la preguntaUse la Prueba de resultados enriquecidos para la elegibilidad en funciones de Google Search y el Schema Markup Validator para la validación general de Schema.org.
  2. Primero los erroresUn error bloquea una función o impide el análisis. Una advertencia normalmente deja el elemento legible o elegible, así que corrija primero los errores.
  3. Nombre al destinatarioMarque una propiedad como obligatoria solo para una función de Google nombrada. La documentación de Article de Google no enumera propiedades obligatorias.
  4. Pruebe la página publicadaTras publicar, pruebe la URL pública. Lea por separado la prueba en vivo y el resultado indexado antes de abrir los informes de mejoras.
  5. Google no es el únicoBing, Yandex y Apple documentan sus propias comprobaciones, y el resultado de un motor no predice la presentación de otro.
  6. Aprobar tiene límitesUna prueba aprobada no garantiza el rastreo, la indexación, el posicionamiento, un resultado enriquecido ni una cita de IA.

Elija una herramienta según la pregunta que se plantea

Schema.org es un vocabulario: una lista compartida de tipos y propiedades para describir contenido. Las funciones de Google Search son productos aparte, construidos sobre una selección de esos tipos, con reglas de elegibilidad propias de Google. Por eso existen dos herramientas. Una pregunta si su marcado usa correctamente el vocabulario, y la otra si Google puede usarlo para una función concreta de Search. La documentación de datos estructurados de Google recomienda empezar con la Prueba de resultados enriquecidos para las funciones de Google Search y usar el Schema Markup Validator para la validación general de Schema.org.

La Prueba de resultados enriquecidos de Google compara el marcado con las funciones de resultados enriquecidos que Google admite actualmente. Informa la elegibilidad de cada función, los problemas con propiedades obligatorias y algunos avisos sobre propiedades recomendadas. Puede probar una URL pública o código pegado, y puede mostrar una vista previa de la apariencia de algunos resultados.

El Schema Markup Validator comprueba el marcado basado en Schema.org sin advertencias específicas de funciones de Google. Sirve para validar el vocabulario, interpretar la sintaxis y revisar tipos que no tienen una función vigente de resultados enriquecidos en Google. Un tipo puede ser Schema.org perfectamente válido y aun así no tener una presentación correspondiente en Google, así que un resultado sin errores aquí no dice nada sobre la elegibilidad en Google. También puede pasar su código por el validador schema de Schema Nova.

Muchos lectores llegan aquí buscando la antigua Structured Data Testing Tool. El anuncio de diciembre de 2020 de Google indicó que la herramienta estaba siendo reenfocada y trasladada a Schema.org, y que ya no comprobaría los tipos de resultados enriquecidos de Google Search. La documentación de Google apunta ahora al Schema Markup Validator para la validación genérica. La guía sobre el reemplazo de la Structured Data Testing Tool explica ese cambio, y la guía sobre resultados enriquecidos y rich snippets explica qué son las funciones de Google en sí.

Lea primero los errores y después las advertencias

Ambas herramientas clasifican los hallazgos en errores y advertencias, y el orden en que los corrige importa. Un error bloquea una función concreta o impide que la herramienta analice el marcado. Las causas típicas son JSON no válido, propiedades obligatorias que faltan, valores de tipo incorrecto, URL inaccesibles o contenido marcado que no coincide con la página visible. Corríjalos primero.

Una advertencia o recomendación normalmente significa que el elemento aún puede analizarse o seguir siendo elegible, pero que más información lo haría más completo. Las advertencias también pueden señalar propiedades obsoletas, campos opcionales o problemas que afectan solo a una función. Lea cada una, decida si la información que falta es verdadera y visible en su página, y agréguela solo cuando lo sea. La guía sobre advertencias de campos faltantes explica esas correcciones propiedad por propiedad.

El significado de un hallazgo depende de la herramienta que lo generó. Un error de la Prueba de resultados enriquecidos significa que la función de Google afectada no es elegible hasta que lo corrija. Una advertencia de esa prueba significa que la función puede seguir siendo elegible, pero que la recomendación merece una revisión. Un error del Schema Markup Validator significa que el marcado quizá no sea válido o no se interprete como se pretendía en Schema.org. En Search Console, un error significa que Google encontró un problema en páginas rastreadas o indexadas, y una advertencia significa que encontró un problema que quizá no impida la indexación ni la elegibilidad.

Dos resultados son fáciles de sobreinterpretar. «Valid» (válido) no significa que Google deba mostrar la función. «No rich result detected» (no se detectó ningún resultado enriquecido) no demuestra que la página carezca de marcado de Schema.org útil; significa que la Prueba de resultados enriquecidos no encontró marcado para una función compatible.

Pruebe un ejemplo de Article antes de publicar

El siguiente ejemplo es un Article ficticio que usa el dominio reservado example.com. Péguelo en las dos herramientas para ver cómo lee cada una el mismo código, y luego reemplace cada valor con datos de su propia página.

json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "@id": "https://example.com/guides/testing-schema#article",
  "url": "https://example.com/guides/testing-schema",
  "headline": "Cómo probar el marcado schema",
  "description": "Una guía práctica para revisar el marcado de Schema.org con validadores de Google y validadores de uso general.",
  "image": [
    "https://example.com/images/testing-schema-1x1.jpg",
    "https://example.com/images/testing-schema-4x3.jpg",
    "https://example.com/images/testing-schema-16x9.jpg"
  ],
  "datePublished": "2026-10-01T09:00:00-05:00",
  "dateModified": "2026-10-15T14:30:00-05:00",
  "author": {
    "@type": "Organization",
    "name": "Example Publishing",
    "url": "https://example.com/about"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example Publishing",
    "url": "https://example.com",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/images/example-publishing-logo.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/guides/testing-schema"
  }
}

Reemplace los valores de url, @id y mainEntityOfPage por la dirección real de su página, y cambie headline y description por el texto que ven los visitantes. Liste sus propias URL de imagen, ponga en datePublished y dateModified las fechas reales con el desfase horario correcto, y coloque su nombre y su dirección en author y publisher. Elija Article, NewsArticle o BlogPosting según corresponda a la página. Cada dato del marcado también debe estar visible en la página y ser exacto, como explican las directrices generales de datos estructurados de Google.

Una mujer con trenza gris y lentes compara con un lápiz dos hojas impresas en una mesa del cuarto trasero de una imprenta, con una laptop abierta a su lado
Figura 1. Comparar el marcado de su código con los datos visibles en la página es la primera revisión, antes de usar cualquiera de las dos herramientas.

Siga este orden. Elija el tipo de Schema.org más específico que encaje con el contenido real de la página, y luego agregue el JSON-LD con sintaxis JSON válida y el contexto https://schema.org. Páselo por el Schema Markup Validator para una interpretación general. Pase el mismo código por la Prueba de resultados enriquecidos si el tipo corresponde a una función vigente de Google Search. Corrija primero los errores de análisis y los errores que bloquean una función, antes que las advertencias opcionales, y solo entonces publique. La Recomendación JSON-LD 1.1 del W3C es la referencia para la sintaxis: exige JSON válido y define @context, @type, los identificadores y los valores vinculados.

Etiquetas de propiedades para las funciones Article y Breadcrumb

La palabra «obligatorio» solo tiene sentido si se nombra al consumidor. Para la función Article vigente de Google, la documentación de Article de Google indica que no hay propiedades obligatorias, y enumera como recomendadas headline, image, datePublished, dateModified y author (con su name y su url). publisher, publisher.logo, description, url, mainEntityOfPage y @id son opcionales para esa función. El vocabulario en sí, incluidos Article y datePublished, lo define Schema.org.

Breadcrumb (ruta de navegación) es una función vigente de Google Search con reglas más estrictas. Según la documentación de Breadcrumb de Google, itemListElement es obligatorio, cada ListItem necesita position y name, y un BreadcrumbList necesita al menos dos objetos ListItem. La propiedad item es obligatoria en las migas intermedias y opcional en la última. Cambie los nombres y las URL del ejemplo por la ruta de navegación de su propia página.

json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Pruebas y correcciones",
      "item": "https://example.com/testing-and-fixing"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Cómo probar el marcado schema",
      "item": "https://example.com/guides/testing-schema"
    }
  ]
}

No existe ningún requisito vigente de una función de Google Search para un Thing, WebPage, DefinedTerm ni ningún otro tipo de Schema.org solo porque sea Schema.org válido. Compruébelos con el Schema Markup Validator y no describa sus propiedades como requisitos de resultados enriquecidos de Google. Para una lista de verificación más amplia, consulte la guía sobre buenas prácticas de marcado schema.

Propiedades del ejemplo de Article según el estado de función en Google

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadFunción Article de GoogleDefinido por
@typeNombra el tipo; esta función lee Article, NewsArticle o BlogPostingTipo de Schema.org
headlineRecomendadaPropiedad de Schema.org
datePublishedRecomendadaPropiedad de Schema.org
author (name, url)RecomendadaPropiedad de Schema.org
publisherOpcionalPropiedad de Schema.org
mainEntityOfPageOpcionalPropiedad de Schema.org

Pruebe la página publicada en orden

Al publicar empiezan otras preguntas. Su código puede ser válido y la página, aun así, estar bloqueada, sin rastrear o servirse de forma distinta a lo que pegó. Empiece por probar la URL pública en la Prueba de resultados enriquecidos, que acepta una URL pública además de código pegado. Luego pase a Search Console.

La herramienta URL Inspection (inspección de URL) de Google necesita una propiedad verificada en Search Console. Según la referencia de URL Inspection de Google, informa el estado de indexación, la información de rastreo y obtención, las URL canónicas, las señales de robots y noindex, el último rastreo y el análisis de resultados enriquecidos. La prueba en vivo examina la página tal como puede obtenerse en este momento, mientras que el resultado indexado muestra la versión que Google tiene almacenada. Léalos por separado: una corrección que hizo esta mañana aparece en la prueba en vivo mucho antes que en el resultado indexado.

La descripción general de depuración de Google explica la diferencia entre las herramientas verificadas y las anónimas.

Dos copias apiladas de una tarjeta de página, una nítida y otra desvanecida, cada una bajo una lupa conectada a su propio panel de informe
Figura 2. Search Console muestra la versión en vivo de una página y la versión indexada por separado, así que léalas como dos resultados.

Después de que Google rastree la página, abra los informes de mejoras (enhancement reports). Según la guía de supervisión de datos estructurados en Search Console (una publicación de 2019, por lo que la interfaz quizá sea distinta hoy), estos informes agrupan los problemas de datos estructurados detectados en las páginas rastreadas. Separan los elementos válidos, las advertencias y los errores, enumeran las URL afectadas y ofrecen «Validate Fix» (validar corrección) cuando modifica algo. Solo existen para las funciones compatibles de Google Search, así que una página con un tipo que no tiene función en Google no aparecerá en ellos.

Vuelva a comprobar después de cualquier cambio en la plantilla, el plugin, el tema o el CMS. Las configuraciones de WordPress, Shopify, Wix, Squarespace y Webflow pueden generar JSON-LD duplicado o alterado. Wix documenta la inserción manual de JSON-LD y indica que el marcado de sus páginas debe ser JSON-LD, y Squarespace explica sus advertencias de datos estructurados y señala que pueden no impedir la indexación ni la elegibilidad para resultados enriquecidos. Use los controles vigentes de cada plataforma y luego pruebe la página pública tal como se muestra. La guía sobre marcado schema duplicado explica cómo encontrar y eliminar las copias.

El orden de las comprobaciones desde el código hasta la página en vivo

  1. Elija el tipoElija el tipo de Schema.org más específico que encaje con el contenido real de la página.
  2. Agregue datos visibles y exactosCada dato marcado también debe aparecer en la página y ser correcto.
  3. Valide Schema.orgPase el código por el Schema Markup Validator y corrija primero los errores de análisis.
  4. Pruebe la función de GooglePase el mismo código por la Prueba de resultados enriquecidos si el tipo tiene una función vigente de Google.
  5. Publique e inspeccionePruebe la URL pública y lea por separado la prueba en vivo y el resultado indexado en Search Console.
  6. Revise y superviseRevise los informes de mejoras tras el rastreo, y Bing, Yandex o Apple cuando corresponda. Vuelva a comprobar después de cada cambio.

Revise Bing y Yandex con sus propias herramientas

Un resultado en las herramientas de Google no predice un resultado en otro motor, así que pruebe donde ese tráfico importa.

Bing admite Schema.org en JSON-LD, Microdata, RDFa, Microformats y Open Graph (guía de datos estructurados de Bing). En Bing Webmaster Tools, la herramienta URL Inspection (inspección de URL) incluye una tarjeta de marcado que reconoce JSON-LD, Microdata, Microformats y Open Graph, y enumera los problemas de marcado de la página inspeccionada. No valida HTML normal.

Yandex Webmaster ofrece un validador de datos estructurados para Schema.org, Microformats, Open Graph, Microdata y RDFa. Yandex indica que el validador también verifica los requisitos de sus servicios. Su guía de Schema.org señala que esos servicios admiten solo algunos tipos, entre ellos productos, recetas, películas, preguntas y respuestas, organizaciones, imágenes y videos, y que los fragmentos mejorados pueden requerir primero indexación y moderación.

DuckDuckGo es un producto de búsqueda aparte cuyos resultados web pueden tomar datos de índices de origen, incluido Bing. Valide la página con Bing y luego revise por separado los resultados reales de DuckDuckGo, en lugar de suponer que uno predice el otro.

Haga que la página sea accesible para la búsqueda con IA

Para que una página sea elegible para la búsqueda de ChatGPT, permita OAI-SearchBot (documentación de rastreadores, artículo de ayuda sobre la búsqueda de ChatGPT). La búsqueda web de Copilot usa resultados de Bing para fundamentar sus respuestas (documentación de búsqueda web de Copilot de Microsoft), así que revise la página en Bing Webmaster Tools. La publicación de Perplexity sobre sus rastreadores documenta los controles de los rastreadores PerplexityBot y Perplexity-User.

Publique contenido preciso, visible y rastreable, y asegúrese de que su marcado describa lo que hay en la página. Consulte si la IA usa el marcado schema.

JSON-LD y JSON Schema son cosas distintas

Como ambos nombres incluyen JSON, quienes buscan uno a menudo llegan a resultados sobre el otro. JSON-LD significa JSON for Linked Data (JSON para datos vinculados). Da a los términos de un documento JSON un significado de datos vinculados mediante un contexto, que es lo que hace la línea @context de su marcado. JSON Schema es un formato aparte para describir y validar la forma de los documentos JSON, por ejemplo qué campos debe contener una respuesta de API.

Para marcar una página con Schema.org, el formato que debe usar es JSON-LD, y es el formato de todos los ejemplos incluidos. Si una herramienta o un tutorial habla de validar los campos de una respuesta de API o de un archivo de configuración, está describiendo JSON Schema.

Qué indica y qué no indica un resultado aprobado

Un resultado sin errores en la Prueba de resultados enriquecidos indica que Google puede leer el marcado de una función compatible y que la página puede ser elegible. Un resultado sin errores del Schema Markup Validator indica que el marcado es interpretable como Schema.org. Ninguno de los dos indica que la página haya sido rastreada o indexada, que vaya a posicionarse, que aparecerá un resultado enriquecido ni que un sistema de IA la citará. Las directrices de Google indican que un marcado correcto no garantiza que se muestre.

Las funciones compatibles también cambian. La página de actualizaciones de la documentación de Google indica que el resultado enriquecido de preguntas frecuentes (FAQ) dejó de aparecer en Google Search el 7 de mayo de 2026, y que la documentación de FAQ se retiró en junio de 2026. FAQPage sigue siendo un tipo de Schema.org, así que el Schema Markup Validator todavía puede validarlo, pero no debe tratarse como una oportunidad de presentación vigente en Google. Revise esa página antes de depender de cualquier función de Google.

Si su marcado pasa ambas herramientas y no aparece nada, la guía sobre por qué no aparecen los resultados enriquecidos explica las causas. Para ver qué marcado ya tiene una página existente, siga la guía sobre cómo revisar si un sitio tiene marcado schema.

Preguntas frecuentes

¿Cuál es la diferencia entre la Prueba de resultados enriquecidos y el Schema Markup Validator?

La Prueba de resultados enriquecidos comprueba el marcado frente a las funciones de Google Search que Google admite actualmente e informa la elegibilidad. El Schema Markup Validator comprueba los tipos y propiedades de Schema.org sin advertencias específicas de funciones de Google. Use el validador para preguntas sobre el vocabulario y la Prueba de resultados enriquecidos para preguntas sobre funciones de Google.

¿El Schema Markup Validator puede decirme si Google mostrará un resultado enriquecido?

No. Comprueba el marcado de Schema.org sin advertencias específicas de Google, así que no informa la elegibilidad para funciones de Google. Incluso la Prueba de resultados enriquecidos informa elegibilidad y no presentación, porque Google decide por separado si muestra un resultado.

¿Las advertencias bloquean algo?

Por lo general, no. Una advertencia normalmente significa que el elemento puede seguir analizándose o siendo elegible, aunque más información lo haría más completo. Corrija primero los errores y luego agregue las propiedades recomendadas que sean verdaderas y estén visibles en la página.

¿Qué pasó con la Structured Data Testing Tool?

El anuncio de diciembre de 2020 de Google indicó que la herramienta se reenfocaría, pasaría a Schema.org y dejaría de comprobar los tipos de resultados enriquecidos de Google Search. La documentación de Google dirige ahora a los usuarios al Schema Markup Validator para la validación genérica y a la Prueba de resultados enriquecidos para las funciones de Google.

¿Google Search todavía muestra los resultados enriquecidos de preguntas frecuentes?

La página de actualizaciones de la documentación de Google indica que el resultado enriquecido de preguntas frecuentes dejó de aparecer en Google Search el 7 de mayo de 2026. La documentación de FAQ se retiró en junio de 2026. FAQPage sigue siendo un tipo de Schema.org válido.

Prueba rápida: ¿qué herramienta corresponde?

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

Quiere saber si su marcado de Article cumple la guía vigente de funciones de Google Search. ¿Qué herramienta usa?

Pregunta 2 de 3

Usa un tipo de Schema.org que no tiene una función vigente de resultados enriquecidos en Google. ¿Qué herramienta lo comprueba?

Pregunta 3 de 3

Su código pasa ambas herramientas, pero Google aún no ha rastreado la página publicada. ¿Cuál es el siguiente paso?

Términos de pruebas de schema

Seleccione un término para ver su definición.

Schema.org. Un vocabulario compartido de tipos y propiedades para describir entidades y contenido.