Guías prácticas

Validar datos estructurados en un sitio web

El marcado válido no puede reparar una página inexacta. Comience con lo que ven los visitantes, luego inspeccione el código, los identificadores y cualquier elegibilidad para una presentación de búsqueda.

Ver el método

Ilustración — Validar datos estructurados en un sitio web
Ilustración generada por IA

Elija una entidad y un propósito claro

Identifique qué representa realmente la página: una organización, artículo, producto, evento o lista. Describa su entidad principal antes de agregar propiedades. Una página de servicio no se convierte en un producto de precio fijo porque existe un tipo de esquema, y la Búsqueda de Google ya no muestra resultados enriquecidos de preguntas frecuentes a partir del 7 de mayo de 2026, según su Actualizaciones oficiales.

Consultar Galería de resultados enriquecidos de Google para el tipo que pretende utilizar. Schema.org ofrece un vocabulario más amplio que las funciones de búsqueda que admite Google. La descripción semántica y la elegibilidad de resultados enriquecidos son preguntas separadas.

Comparar valores con contenido publicado

Compare nombres, descripciones, imágenes, autores, fechas, direcciones, precios y disponibilidad con lo que un visitante puede ver. Elimine las revisiones, calificaciones, cantidades o ubicaciones inventadas. Políticas de Google Requiere contenido visible representativo y no garantiza un resultado rico.

Para las páginas traducidas, utilice los valores y las URL de ese idioma. Las fechas deben describir la publicación o modificación real. Evite presentar una página de área de servicio como una ubicación comercial física separada.

  • Valores verificables en la página.
  • Fechas e imágenes consistentes.
  • No hay reclamaciones de características garantizadas.

Validar sintaxis e identificadores

Lea el JSON-LD de la página final, incluido el resultado renderizado si JavaScript lo crea. Compruebe las propiedades requeridas o recomendadas para la función de destino, URL absolutas, duplicados y valores de @ID estables. Prueba de resultados ricos y Validador de esquema.org Responda diferentes preguntas: soporte de Google y validación de vocabulario.

Solucione los problemas de sintaxis en la plantilla o en el origen de datos y, a continuación, muestre varias páginas de ese tipo. Un solo ejemplo no revelará campos vacíos, escapando errores o datos de entrada inusuales en otros lugares.

Distinga identidad de entidad y dirección del documento. En JSON-LD, @id aporta un identificador de nodo; las referencias relativas se interpretan con base y contexto. Ejemplo ficticio: dos descripciones con la misma IRI absoluta https://example.com/#org identifican el mismo nodo aunque aporten propiedades distintas. Dos organismos con igual nombre no se convierten por ello en una entidad. No reutilice el identificador de organización para su página, autor o establecimientos distintos.

Un @id con #org no crea automáticamente un elemento HTML id="org". Si también ofrece navegación a una sección, pruebe la diana HTML aparte. Mantenga identificadores entre plantillas cuando describan la misma entidad, identificando correctamente páginas lingüísticas y contenidos. Compare propiedades con la página visible: JSON válido, identidad coherente y elegibilidad Google son controles distintos. Ninguno garantiza resultados enriquecidos.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Referencias ficticias: identidad JSON-LD y destino HTML
SituaciónReferenciaControl
Dos descripciones de la misma organizaciónMisma IRI absoluta @id tras resoluciónVerificar que sea la misma entidad
Organismos homónimosEl nombre igual no bastaMantener identidades distintas salvo relación probada
Identificador de entidadhttps://example.com/#orgNo crea por sí solo destino HTML
Valor distinto del contenido visibleJSON válido pero información incoherenteCorregir fuente y comprobar contenido y marcado

Supervisar los cambios y limitaciones

Después de la publicación, revise los errores de Search Console si existe un informe para ese tipo. Compara varias URL y fechas de rastreo; La ausencia de un resultado rico por sí solo no prueba el margen de beneficio. Las características y los criterios pueden cambiar.

Incluya el marcado en las comprobaciones editoriales: cuando el contenido, las imágenes, los precios o las plantillas cambian, vuelva a verificar su representación estructurada. Los Guía de prelanzamiento Coloca este cheque en una revisión de lanzamiento más amplia.

  • Un ejemplo de cada plantilla marcada.
  • Errores rastreados con fechas.
  • Vuelva a verificar después de los cambios de contenido o código.

Contrastar los datos estructurados

Etiqueta vacía y hoja de control junto a un objeto y un portátil
Ilustración generada por IA · Compare los valores codificados con la información visible en la página.

Caso propuesto: cambia la oferta visible, pero el JSON conserva una condición antigua. El código válido puede describir algo incorrecto.

Compare valores, fechas y disponibilidad con la página. Separe validación técnica, coherencia del contenido y posibles requisitos del buscador.

  • Leer la oferta visible
  • Comparar sus valores con el JSON
  • Registrar las diferencias

Documentos de referencia

Contenido actualizado

Referencias documentadas para este tema

Referencias documentadas para este tema
ReferenciaValor o sintaxisAlcance
W3C · JSON-LD 1.1
application/ld+json · @contextJSON-LD describe datos enlazados; sintaxis válida y exactitud de los hechos son verificaciones distintas.
RFC 8259 · JSON
application/json · UTF-8JSON estándar no admite comentarios ni comas finales; las cadenas usan comillas dobles.

Las fechas indican la consulta de las referencias. Estos datos no constituyen una auditoría ni una declaración global de conformidad.

Matriz de validación funcional para adaptarse al proyecto

Estos controles propuestos utilizan casos ficticios. Decida qué comportamiento se espera con el equipo, anote el resultado y asigne discrepancias no resueltas antes de la publicación.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Casos de prueba, resultados esperados y evidencia útil
CasoResultado esperadoPrueba para mantener
El precio visible cambia pero JSON-LD mantiene el valor anterior.El marcado refleja el precio publicado sobre la misma base.Registre la URL, los pasos, el resultado y la evidencia fechada.

Preguntas frecuentes

¿Pueden existir reseñas o precios solo en JSON-LD?

Los datos estructurados deben coincidir con la información de la página. No invente reseñas, calificaciones, direcciones o precios para obtener resultados enriquecidos. Verifique los tipos, las propiedades y la coherencia con el contenido visible. El marcado válido no garantiza una pantalla de motor de búsqueda.