Datos estructurados que no se pueden analizar: encuentra y corrige el JSON-LD roto

Por qué importa

Un bloque JSON-LD que no se puede analizar es invisible para Google. Sus productos, valoraciones o rutas de exploración desaparecen de los demás informes, así que este informe puede explicar una caída repentina de elementos válidos.

Qué significa cada mensaje

• Error de análisis: Faltan caracteres "," o "}": falta una coma entre dos campos o una llave sin cerrar.
• Error de análisis: Falta un carácter ":": un nombre de campo no tiene los dos puntos antes de su valor.
• Error de análisis: Falta el carácter "}" o el nombre del miembro del objeto: Google esperaba un nombre de campo. Una coma sobrante antes de una llave de cierre puede causarlo.
• Error de análisis: Faltan caracteres "," o "]" en la declaración de la matriz: a una lista le falta una coma o no está cerrada.
• La secuencia de escape de la cadena no es correcta: una barra invertida en un texto que JSON no permite, como \'.
• Elemento de nivel superior no válido: la capa exterior del bloque no es un objeto ni una lista JSON.
• La propiedad única está duplicada: una propiedad que solo puede aparecer una vez aparece dos.
• El documento JSON no es válido: Google no pudo leer el bloque como JSON.

El informe tiene más, como El número no es válido y Hay un carácter Unicode truncado. Haz clic en cualquier fila para ver las páginas y los detalles del error.

Lo que más rompe el JSON-LD

• Una edición a mano. En el foro de Shopify, una tienda añadió hasMerchantReturnPolicy y shippingDetails a main-product.liquid y se dejó una coma antes del siguiente campo. Esa plantilla se usa en todas las páginas de producto, así que una coma rompió todas.
• Texto pegado tal cual. Un nombre de producto con comillas dobles, como una sartén de 12", cierra la cadena antes de tiempo. En Shopify Liquid, escribe los valores con el filtro json, como {{ product.title | json }}, para que las comillas se escapen.
• Una coma sobrante después del último campo. JavaScript la permite. JSON no.
• Dos bloques en una misma etiqueta script. Ponlos en una lista o dale a cada uno su propia etiqueta.

<!-- Antes: comillas sin escapar y una coma sobrante -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Sartén de hierro 12" curada",
  "image": "https://example.com/fotos/sarten.jpg",
}
</script>

<!-- Después -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Sartén de hierro 12\" curada",
  "image": "https://example.com/fotos/sarten.jpg"
}
</script>

Encuentra la línea rota

1. Abre una página de ejemplo del informe. Mira el código fuente y busca application/ld+json.
2. Pega el bloque en la prueba de resultados enriquecidos o en el Schema Markup Validator. Los dos señalan la línea con el error.
3. ¿Sigues sin encontrarlo? La ayuda de Google propone empezar con un objeto vacío y volver a añadir tu código por partes hasta que falle.
4. Corrige la plantilla, el ajuste del plugin o la app que escribe el bloque, no una sola página. Una corrección arregla todas las páginas que lo usan.

Cuando el bloque se puede analizar, Google puede leer lo que contiene. Eso puede hacer aparecer avisos nuevos en Fichas de comerciante u otros informes que el error de sintaxis ocultaba.

Confirma la corrección

Cuando todas las páginas estén corregidas, haz clic en Validar corrección en el problema. Google dice que la validación suele tardar unas dos semanas, y a veces mucho más.

JSON-LD roto, en tu lista de correcciones

En los planes de pago, CrawlCoach lee el HTML de tus páginas que están en Google y comprueba que cada bloque JSON-LD se pueda analizar. Un bloque que no se puede analizar entra en tu lista de correcciones con la página y los pasos, y CrawlCoach vuelve a revisar la página publicada para confirmar la corrección. Cuando todas las páginas que lee de una misma plantilla comparten el error, te da una sola corrección de plantilla.

Preguntas frecuentes

Fuentes

Revisado el 8 de octubre de 2026. Google cambia Search Console y su ayuda de vez en cuando. Si algo no coincide con lo que ves en pantalla, consulta la fuente.

• Ayuda de Search Console: Informe de datos estructurados que no se pueden analizar
• Ayuda de Search Console: Depurar datos estructurados que faltan o disminuciones en los elementos de datos estructurados
• Ayuda de Search Console: Descripción general del informe de resultados enriquecidos
• Referencia de Shopify Liquid: filtro structured_data (en inglés)