Qué es JSON-LD y cómo usarlo en datos estructurados
Por Tiago CostaActualizado el 2 de julio de 2026
JSON-LD (JavaScript Object Notation for Linked Data) es la forma recomendada de escribir datos estructurados. En la práctica:
- vive en un bloque de script separado, sin ensuciar el HTML visible;
- usa el vocabulario de Schema.org para etiquetar cada dato;
- indica a Google si un fragmento es un autor, un precio, una nota o una fecha;
- habilita resultados enriquecidos (estrellas, FAQ, imagen) en la página de resultados.
Qué es JSON-LD
JSON-LD son las siglas de JavaScript Object Notation for Linked Data, un formato para describir datos de manera que tanto humanos como máquinas puedan leerlos. En el contexto del SEO, cumple un papel muy concreto: es la forma recomendada de agregar datos estructurados a una página, dentro de un bloque de script.
La idea central es dar significado explícito al contenido. Para una persona, la frase "artículo escrito por Ana Silva el 12 de mayo" es clara. Para el buscador, es solo texto. Con JSON-LD, etiquetas "Ana Silva" como el autor (author) y la fecha como datePublished, y Google pasa a entenderlo como metadatos fiables, y puede mostrar el autor y la fecha en el resultado.
Conviene separar dos sentidos. Para desarrolladores, JSON-LD es un estándar del W3C usado en cualquier intercambio de datos enlazados. Para el SEO, es sobre todo el vehículo del schema markup: el sobre donde se escribe el vocabulario de Schema.org para generar resultados enriquecidos.
Cómo funciona JSON-LD
Un JSON-LD para SEO vive dentro de una etiqueta <script type="application/ld+json">, normalmente en el head o al final del body de la página. Como queda aislado del HTML visible, no interfiere en el diseño y es fácil de mantener, que es justo por lo que Google lo prefiere.
Todo bloque empieza con dos claves obligatorias. La propiedad @context apunta al vocabulario usado (casi siempre Schema.org), y la propiedad @type define qué es la página (un Article, un Product, una FAQPage). A partir de ahí, rellenas las propiedades de ese tipo, como name, author, price o datePublished.
El flujo es directo: el crawler rastrea la página, encuentra el bloque JSON-LD, interpreta cada propiedad y, si el contenido es elegible, muestra un recurso enriquecido en el resultado. Los mismos datos también ayudan a alimentar el grafo de conocimiento, conectando entidades como personas, marcas y productos.
JSON-LD, Microdata y RDFa: por qué Google prefiere JSON-LD
El vocabulario de Schema.org puede escribirse en tres sintaxis diferentes. Entender las diferencias ayuda a elegir la que da menos trabajo y menos errores.
| Formato | Dónde va | Mantenimiento |
|---|---|---|
| JSON-LD | En un bloque de script separado del contenido. | Fácil, no depende del HTML visible. |
| Microdata | En atributos repartidos por las etiquetas del HTML. | Laboriosa, se rompe con cambios de diseño. |
| RDFa | En atributos dentro de las etiquetas, como Microdata. | Laboriosa y más verbosa. |
Google recomienda oficialmente JSON-LD justamente porque separa el marcado del contenido, como explica la documentación de Google Search Central. Y el mercado siguió ese camino: según el Web Almanac 2024, de HTTP Archive, JSON-LD ya aparece en el 41% de las páginas analizadas (frente al 34% en 2022) y es el formato que más crece.
Ejemplo de JSON-LD en la práctica
Nada lo explica mejor que ver el código. Abajo, un ejemplo mínimo de marcado de un artículo de blog con JSON-LD:
- @context: "https://schema.org", el vocabulario usado.
- @type: "Article", diciendo que la página es un artículo.
- headline: el título del artículo.
- author: un objeto de tipo Person con el nombre de quien lo escribió.
- datePublished: la fecha de publicación en formato ISO (por ejemplo 2026-05-12).
En la práctica, ese bloque entra dentro de una etiqueta de script en el HTML. Cada tipo de Schema.org tiene propiedades obligatorias y recomendadas, y rellenar también las recomendadas, no solo el mínimo, aumenta bastante la posibilidad de que el resultado enriquecido se muestre. Un mismo tipo de página suele reutilizar la misma plantilla de marcado, cambiando solo los valores.
Cómo crear y validar tu JSON-LD paso a paso
No necesitas escribirlo todo a mano. Una rutina que funciona para la mayoría de los sitios:
- Elige el tipo correcto: identifica qué representa la página (un artículo, un producto, una FAQ) y selecciona el tipo correspondiente en Schema.org.
- Genera el bloque: usa un generador de JSON-LD o un plugin de SEO. En plataformas como WordPress, las extensiones insertan el marcado automáticamente.
- Rellénalo con datos reales: nunca marques una valoración o un precio que no existe en la página, porque eso viola las directrices y puede generar una penalización.
- Valida antes de publicar: pasa el bloque por el Test de Resultados Enriquecidos de Google y por el validador de Schema.org para detectar errores y avisos.
- Monitoriza en Search Console: sigue el informe de mejoras para ver qué páginas son elegibles y corregir problemas.
Una vez publicado, el buscador necesita rastrear la página de nuevo para reconocer el marcado, así que los resultados enriquecidos pueden tardar unos días en aparecer.
JSON-LD, SEO y visibilidad en IA
JSON-LD no es un factor directo de posicionamiento, pero trabaja a favor del SEO de dos formas. Primero, habilita resultados enriquecidos, que ocupan más espacio, llaman más la atención y tienden a recibir más clics. Segundo, deja el contenido más claro para la máquina, reduciendo la posibilidad de que el buscador interprete mal la página.
Hay además una ganancia más reciente. Los buscadores generativos y los asistentes de IA usan la estructura semántica para entender y citar contenido con más confianza. Una página bien marcada con JSON-LD tiende a ser más fácil de resumir y referenciar dentro de los AI Overviews, sumando valor de SEO tradicional al de optimización para IA. Por ser ligero, estandarizado y recomendado por Google, JSON-LD se convirtió en la base técnica de cualquier estrategia seria de SEO técnico.