Ir al contenido

Glosario JSON-LD

¿Qué es JSON-LD?

Manuel Riveiro Rodriguez
Manuel Riveiro Rodriguez

CEO & Digital Strategist

8 min revisado el 08.08.2026

  • SEO Técnico
Definición

JSON-LD (JSON for Linking Data) es el formato de datos estructurados especificado por el W3C que añade información semántica a una página mediante un bloque <script type="application/ld+json">, separado del código HTML visible.

Una cinta de papel perforada saliendo de un lector antiguo, sin nada impreso, junto al título JSON-LD
Agujeros en una cinta: la máquina lee lo que tú no
En esta página 6
  1. ¿Qué es JSON-LD?
  2. JSON-LD frente a Microdata y RDFa
  3. Cómo funciona
  4. Por qué importa
  5. Buenas prácticas
  6. Errores frecuentes
En breve

Cómo se construye un bloque JSON-LD, por qué Google lo recomienda frente a Microdata y RDFa, y qué diferencia real hay entre el Rich Results Test y el validador de Schema.org.

Una cinta de papel perforada saliendo de un lector antiguo, sin nada impreso, junto al título JSON-LD
Agujeros en una cinta: la máquina lee lo que tú no

¿Qué es JSON-LD?

JSON-LD son las siglas de JSON for Linking Data, un formato para serializar datos vinculados definido por el W3C y actualizado a la versión 1.1 en julio de 2020. Permite describir el contenido de una página con el vocabulario de Schema.org usando la sintaxis de JSON, un lenguaje que cualquier desarrollador web ya conoce de antemano.

A diferencia de otros métodos, JSON-LD vive dentro de un bloque <script type="application/ld+json"> que se coloca en el <head> o el <body> del documento, sin mezclarse con las etiquetas que construyen el diseño visible. Es una de las formas de datos estructurados que ayudan a los motores de búsqueda a entender de qué trata una página más allá del texto que lee un visitante.

Google recomienda JSON-LD como formato preferente porque, según su propia documentación de Search Central, "es la solución más sencilla de implementar y mantener a escala" para quien gestiona un sitio web. Esa recomendación explica por qué la mayoría de plugins SEO y gestores de contenido lo generan por defecto, incluso para casos simples como un rich snippet de valoraciones.

JSON-LD frente a Microdata y RDFa

FormatoDónde se escribe el códigoFacilidad de mantenimiento
JSON-LDBloque <script> independiente, normalmente en el <head>Alta: se edita sin tocar el HTML visible
MicrodataAtributos itemscope, itemtype e itemprop dentro de las propias etiquetas HTMLMedia: un cambio de diseño puede romper el marcado
RDFaAtributos vocab, typeof y property, también incrustados en el HTMLMedia-baja: sintaxis más verbosa y menos extendida

La diferencia técnica de fondo es la separación del código. En una implementación de SEO técnico basada en JSON-LD, el marcado se puede generar, editar o eliminar por completo sin tocar una sola etiqueta del HTML visible. Con Microdata y RDFa, en cambio, cada atributo está tejido dentro de la misma etiqueta que renderiza el contenido, así que cualquier rediseño de plantilla obliga a revisar también el marcado semántico.

Cómo funciona

Un bloque JSON-LD se construye con un pequeño número de claves reservadas. @context indica el vocabulario que se está usando, casi siempre https://schema.org, y evita ambigüedades sobre qué significa cada propiedad. @type declara qué clase de entidad se describe (Article, Product, FAQPage, Organization...), y a partir de ahí se añaden las propiedades específicas de ese tipo: name, description, datePublished, price o cualquier otra que defina el vocabulario. Estas propiedades admiten valores anidados, como un autor descrito como un objeto Person completo dentro del mismo bloque, sin necesidad de crear un script aparte para esa información.

Una misma página puede incluir varios bloques <script type="application/ld+json"> independientes: por ejemplo uno para el artículo y otro para el breadcrumb. También se pueden combinar varias entidades dentro de un único bloque usando la clave @graph, algo más ordenado cuando existen relaciones entre ellas, como un artículo que pertenece a una organización y que a la vez incluye una lista de preguntas frecuentes.

Para que Google entienda que dos bloques en páginas distintas hablan de la misma entidad, como el logotipo y los datos de contacto de una empresa, se usa @id: un identificador único, normalmente una URL con ancla del tipo https://midominio.com/#organization, que se repite en cada página donde aparece esa entidad. Así se evita duplicar información y se refuerzan los datos estructurados del sitio como un conjunto coherente.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "¿Qué es JSON-LD?",
  "url": "https://zds.es/que-es-json-ld",
  "datePublished": "2026-08-08",
  "author": {
    "@type": "Organization",
    "@id": "https://zds.es/#organization",
    "name": "ZDS",
    "url": "https://zds.es"
  }
}
</script>

Por qué importa

JSON-LD es el paso previo para que Google muestre un rich snippet en los resultados de búsqueda: estrellas de valoración, precios, preguntas desplegables o migas de pan visuales en el propio SERP. Sin el marcado correcto, esa información extra no aparece, aunque el contenido esté perfectamente visible para el usuario en la página.

Al vivir separado del HTML, el marcado se integra bien en flujos de trabajo de SEO técnico: se puede generar de forma dinámica desde una plantilla o un CMS sin arriesgar el diseño de la página, y un equipo de desarrollo puede modificarlo sin coordinarse con quien mantiene el HTML visible.

Cada vez más, este mismo marcado ayuda a que los sistemas de IA generativa entiendan el contenido de una página al citarla en respuestas conversacionales. Es un uso que se suma al de los resultados enriquecidos y convierte a JSON-LD en una tarea técnica habitual, del mismo tipo que vigilar los Core Web Vitals o la velocidad de carga de un sitio.

Buenas prácticas

  • Valida cada bloque con el validador de Schema.org y, después, con el Rich Results Test: el primero comprueba el vocabulario completo, el segundo solo lo que genera resultados enriquecidos en Google.
  • Usa un @id consistente en organization, logo y sameAs para que Google enlace la misma entidad en distintas páginas del sitio.
  • Coloca el bloque en el <head> o justo antes de cerrar <body>, nunca duplicado dentro de componentes que se cargan más de una vez en la misma página.
  • Limita el marcado a lo que realmente existe en la página visible: no describas un precio, una valoración o una FAQ que el usuario no puede ver.
  • Revisa el marcado tras cada migración o rediseño de plantilla, porque un cambio de plataforma puede eliminar el bloque <script> sin que se note en el diseño, un fallo típico de SEO técnico que pasa meses sin detectarse.
  • Documenta qué tipo de Schema.org usa cada plantilla para evitar que dos desarrolladores implementen el mismo dato con propiedades distintas.

Errores frecuentes

  • Declarar un @type que no corresponde al contenido real de la página, por ejemplo Product en una página informativa sin precio ni disponibilidad.
  • Dejar el bloque JSON-LD con datos de una versión anterior de la página tras una actualización de contenido, generando información desincronizada con lo que ve el usuario.
  • Usar un @context distinto de https://schema.org sin necesidad real, lo que complica la interpretación del marcado por parte de los buscadores.
  • Confundir el resultado del Rich Results Test con una validación completa: la prueba pasa y aun así puede haber errores de vocabulario que solo detecta el validador de Schema.org.
  • Repetir el mismo bloque JSON-LD en varios componentes de la plantilla y acabar con datos duplicados o contradictorios en una sola página.
Manuel Riveiro Rodriguez CEO & Digital Strategist

Una auditoría técnica revisa esto y el resto en un solo paso.

Solicitar auditoría

Preguntas frecuentes

¿JSON-LD afecta al posicionamiento de una página?

No de forma directa. Google ha repetido en varias ocasiones que el marcado JSON-LD no es un factor de ranking por sí mismo. Lo que sí hace es habilitar resultados enriquecidos y ayudar a los motores a entender el contenido con más precisión, algo que puede mejorar el CTR aunque no mueva la posición en el ranking.

¿Puedo tener varios bloques JSON-LD en la misma página?

Sí. Es habitual combinar, por ejemplo, un bloque para el artículo, otro para el breadcrumb y otro para la organización. También se pueden agrupar varias entidades dentro de un único bloque con la clave @graph, más ordenado cuando las entidades están relacionadas entre sí.

¿Qué diferencia hay entre el Rich Results Test y el validador de Schema.org?

El Rich Results Test de Google solo comprueba los tipos de marcado que pueden generar un resultado enriquecido en su buscador. El validador de Schema.org, en cambio, revisa el marcado contra todo el vocabulario oficial, incluidos tipos que Google no usa para resultados enriquecidos.

¿JSON-LD sustituye a las etiquetas meta tradicionales?

No. JSON-LD complementa a etiquetas como title o meta description, no las reemplaza. Los motores siguen usando esas etiquetas para el título y el fragmento de los resultados; el marcado JSON-LD añade una capa adicional de contexto semántico sobre el mismo contenido.

¿Necesito saber programar para añadir JSON-LD a mi web?

Depende del sistema. Muchos gestores de contenido y plugins SEO generan el bloque de forma automática a partir de campos que ya rellenas. Para casos personalizados sí hace falta editar código JSON dentro de la etiqueta script, aunque la sintaxis es más simple que la de Microdata o RDFa.

Fuentes

  1. W3C JSON-LD 1.1 Recommendation: especificación oficial que define la sintaxis y el vocabulario base de JSON-LD como formato para serializar datos vinculados. Publicada el 16.07.2020.
  2. Google Search Central — Introducción a los datos estructurados: documenta la recomendación explícita de Google de usar JSON-LD frente a Microdata y RDFa. Actualizada el 10.12.2025.
  3. Schema.org Validator: herramienta independiente de Google que valida el marcado contra el vocabulario completo de Schema.org, más allá de lo que genera resultados enriquecidos.