Técnico

Advertencia

Entidades HTML doble-escapadas en los datos estructurados

Este error aparece cuando los datos estructurados (JSON-LD) de una página contienen entidades HTML escapadas dos veces, como &amp; en vez de &. Aquí te explicamos qué implica y cómo solucionarlo.

Qué significa este error

Los datos estructurados en formato JSON-LD conviven con el HTML del que forman parte, así que su texto puede pasar por dos sistemas de escapado distintos: el de HTML y el de JSON. Cuando conviven correctamente no hay problema. El problema aparece cuando algo del lado del HTML —un plugin de caché, un minificador o el propio CMS— vuelve a escapar un JSON-LD que ya estaba bien formado. El resultado es una entidad HTML escapada dos veces: en vez de & te queda &amp;, en vez de una comilla te queda &quot;, en vez de un símbolo Unicode te queda algo como &#10004;. Durante años esto pasaba desapercibido porque Google desenrollaba el doble escapado y sacaba el campo adelante igual. Desde que dejó de hacerlo, ese texto le llega tal cual: literal, sin decodificar, y el campo que lo contiene deja de ser válido para los resultados enriquecidos. Es un error silencioso. No rompe la página ni se ve navegando; solo aparece si miras el JSON-LD tal y como lo recibe Google.

Por qué es importante corregirlo

Que tus datos estructurados tengan campos con doble escapado no tira tu web abajo, pero sí te resta las ventajas que se supone que te iban a dar los datos estructurados.

Pierdes elegibilidad para rich results

Si el campo afectado es uno de los que Google necesita para mostrar una función especial (estrellas, FAQ, eventos...), llega corrupto y Google puede descartarlo.

Los datos no dicen lo que crees que dicen

Un nombre, una descripción o un precio pueden llegar con &amp; literal en medio, en vez del carácter real.

Es fácil que pase desapercibido durante meses

No rompe nada visualmente, así que se puede acumular en todo el sitio sin que nadie lo note, sobre todo si viene de un plugin de caché activado globalmente.

Cómo solucionarlo paso a paso

Arreglarlo no consiste en tocar el JSON-LD que ya escribiste, sino en encontrar qué lo está reescapando por el camino.

Paso 1

Localiza qué toca el HTML después de generarse

Los sospechosos habituales son plugins de caché, minificadores de HTML y optimizadores que comprimen el código.

Dónde aplicarlo: Configuración de caché/minificado del CMS o servidor.

Paso 2

Excluye del minificado los bloques <script type="application/ld+json">

La mayoría de plugins permite excluir etiquetas concretas del minificado.

Dónde aplicarlo: Opciones avanzadas del plugin de caché/minificado.

Paso 3

Usa escapes estándar de JSON, no entidades HTML

Si generas el JSON-LD tú mismo, usa \", \n, & en vez de entidades HTML.

Dónde aplicarlo: Código o plantilla que construye el JSON-LD.

Paso 4

Valida el resultado

Comprueba que el campo ya no muestra el texto doble-escapado.

Dónde aplicarlo: Test de resultados enriquecidos de Google.

Si quieres entenderlo aún mejor

Para ayudarte a entender mejor este tipo de error y por qué ocurre, incluimos materiales adicionales que amplían las explicaciones, guían con ejemplos o muestran métodos alternativos.

Test de resultados enriquecidos de Google

Comprueba cómo interpreta Google los datos estructurados de una URL concreta, incluidos los campos afectados por el doble escapado.

Ver recurso

¿Tu sitio tiene este problema?

Audita tu web gratis y descubre si este y otros errores SEO están afectando tu posicionamiento.

Ver todos los errores que detectamos