SEO

JSON-LD

También: datos estructurados JSON-LD, schema en JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) es el formato de datos estructurados que Google prefiere: un bloque de script con JSON de datos enlazados, colocado en una página, que describe a los buscadores la entidad de esa página sin tocar el HTML visible.

El JSON-LD vive en una etiqueta script con el tipo application/ld+json, normalmente en el head o en el body de la página. Como se sitúa aparte del marcado renderizado, no intercala atributos a lo largo de tu HTML como hacen microdata y RDFa, y por eso Google lo recomienda y por eso es el formato más fácil de añadir, auditar y quitar sin alterar la maquetación. Cada bloque es un objeto autónomo con un @context que apunta al vocabulario de schema.org y un @type que nombra la entidad, de modo que una máquina puede leer la página como datos en lugar de adivinar el significado a partir de la prosa.

Un solo bloque puede describir un producto, un artículo, una organización, una ruta de migas de pan o las valoraciones agregadas de las reseñas, y varios bloques pueden coexistir en una misma página. El formato es simplemente JSON, así que resulta sencillo de generar para una plantilla y de leer para un validador, y puede inyectarse después de la carga de la página mediante gestores de etiquetas cuando no puedes editar la plantilla directamente. También puedes enlazar entidades por referencia con @id, de modo que un bloque Product apunte a la Organization que lo vende sin repetir los datos de la marca al completo.

Piensa en una tienda de Shopify que vende un café de origen único. La plantilla de producto renderiza un bloque AggregateRating con un ratingValue de 4,7 sobre un reviewCount de 213, un bloque Offer con price 18.00, priceCurrency USD y availability fijada en InStock, y un bloque Organization aparte en cada página que describe el tostadero y su logotipo. Cuando el comerciante lanza una oferta flash, el tema debe regenerar el precio del JSON en el mismo momento en que cambia el precio en la página, porque de lo contrario ambos quedan desincronizados. Si un producto se agota, availability tiene que pasar a OutOfStock también en el marcado, o Google puede seguir mostrando un precio y un estado de stock que ya no son ciertos.

El JSON-LD también importa para los motores de respuesta. ChatGPT, Perplexity y Google AI Overviews se apoyan en señales limpias y analizables al decidir de qué trata una página y si citarla, y un bloque bien formado elimina la ambigüedad sobre el nombre del producto, el precio, la valoración y el vendedor. No es una garantía de que te citen, y estos sistemas siguen leyendo el texto visible, pero los datos estructurados reducen el coste de entender la página y hacen que los datos clave sean más difíciles de malinterpretar.

La advertencia honesta es que el JSON-LD debe coincidir con lo que el visitante ve de verdad. Google trata como una infracción de sus directrices los datos estructurados que declaran valoraciones, precios o contenido que no están presentes en la página, y puede suprimir los resultados enriquecidos o emitir una acción manual. Mantén el JSON sincronizado con el contenido visible, valídalo después de cada cambio de plantilla y trátalo como una descripción fiel de la página, no como un lugar para hacer afirmaciones de más.