Aprender
Errores de datos estructurados: corrige JSON-LD, schema markup y rich results
Una guía práctica de errores de datos estructurados: qué bloquea los rich results frente a lo que solo es un aviso, los errores JSON-LD comunes y cómo validar la corrección.
Ejecuta una auditoría nueva en DomainLens y usa el informe como lista de prioridades.
Qué hacen los datos estructurados y dónde fallan
Los datos estructurados son marcado legible por máquina — casi siempre JSON-LD — que le dice a los buscadores de qué trata una página: un producto con precio, un artículo con autor, una receta con tiempo de cocción. Cuando son válidos y coinciden con el contenido visible, la página se vuelve elegible para rich results: estrellas, precios, FAQ, breadcrumbs y otros resultados enriquecidos.
Fallan de dos formas. Técnicamente, el JSON-LD puede estar mal formado o faltarle propiedades requeridas, y Google no puede analizarlo. Editorialmente, el marcado puede describir algo que la página no muestra, una infracción de directrices que puede provocar una acción manual. Ambos quitan la elegibilidad, pero se depuran de forma muy distinta.
Errores vs avisos: qué bloquea de verdad los rich results
La Prueba de resultados enriquecidos y Search Console separan los problemas en errores y avisos, y la distinción importa:
- Los errores son propiedades requeridas ausentes (p. ej. un Product sin name, un Offer sin price). Hacen el elemento no elegible — corrígelos primero.
- Los avisos son propiedades recomendadas ausentes (p. ej. sin aggregateRating, sin imagen). El elemento sigue siendo elegible, pero un resultado más completo puede ganar el puesto.
- Los valores inválidos — tipos incorrectos, formatos de fecha malos, precios como texto — se tratan como errores para el campo afectado.
- Una página puede tener sintaxis válida y aun así no ser elegible si el tipo de elemento no es uno que Google admite para rich results.
Los errores JSON-LD más comunes
- Marcado que no coincide con la página visible — una valoración o precio en JSON-LD que el usuario no ve es una infracción.
- Campos requeridos ausentes: Product sin offers/price, Article sin headline, BreadcrumbList sin position en cada elemento.
- Tipos incorrectos: precio o valoración como cadena con símbolo de moneda, fechas fuera de ISO 8601, URLs relativas en vez de absolutas.
- Varios bloques contradictorios — dos Organization o dos Product en una página con valores distintos.
- JSON-LD inyectado por JavaScript que no sobrevive al HTML renderizado que indexa el crawler.
Cómo encontrar y corregir errores de schema
- Pasa la URL por la Prueba de resultados enriquecidos de Google en la página en directo y lee cada error y aviso por elemento.
- Contrasta con el Schema Markup Validator (schema.org) para problemas puros de sintaxis y vocabulario.
- En Search Console usa los informes de mejoras (Productos, Breadcrumbs, FAQ) para ver errores a escala entre plantillas.
- Corrige primero las propiedades requeridas, alinea cada valor con lo que muestra la página y luego añade propiedades recomendadas.
- Si el marcado lo inyecta JS, confirma que existe en el HTML renderizado, o pásalo al servidor.
Errores que degradan o eliminan rich results
- Marcar contenido no visible, o añadir marcado de reseñas a páginas que no lo son — ambos pueden provocar una acción manual.
- Corregir una plantilla de producto y suponer todo el catálogo limpio; los errores de schema son por plantilla y escalan rápido.
- Perseguir avisos ignorando el único error que hace el elemento no elegible.
- Añadir schema para tipos que Google no renderiza y luego extrañarse de que no aparezca rich result.
Cómo validar el schema markup
Tras la corrección, vuelve a ejecutar la Prueba de resultados enriquecidos en la URL en directo y confirma cero errores para el tipo que quieres, y luego sigue el informe de mejoras en Search Console mientras la corrección se despliega por las plantillas los días siguientes.
En DomainLens, los datos estructurados se comprueban en la misma auditoría que títulos, canónicas y renderizado — un bloque Product o Article mal formado, ausente o presente solo tras JavaScript aparece junto al resto del SEO técnico, no en un silo aparte.