Blog

ES
¿Qué es JSON-LD y por qué es importante?

¿Qué es JSON-LD y por qué es importante?

4 min de lectura

Aprende qué es JSON-LD y cómo usar este formato de datos enlazados para mejorar el SEO de tu web y aparecer en los paneles de conocimiento de Google.

¿Qué es JSON-LD?

JSON-LD (JSON for Linked Data) es un formato basado en JSON para estructurar datos enlazados. Su principal ventaja es que es muy fácil de usar y permite definir el contexto de los elementos de una página web. Como en el siguiente ejemplo:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Person",
  "name": "Andres Parra",
  "jobTitle": "Software Engineer",
  "affiliation": "RPCIDE",
  "additionalName": "byandrev",
  "url": "https://byandrev.dev"
}
</script>

En el ejemplo anterior, definimos un objeto de tipo Person con datos que aportan más información sobre esa persona. Al proporcionar estos datos estructurados, ayudamos a que los buscadores (como Google) comprendan mejor quién es la persona y qué rol cumple.

Cuando buscas a alguien en Google y ves un recuadro de información a la derecha (Knowledge Panel), lo más probable es que el buscador esté utilizando JSON-LD para extraer y mostrar esos datos de forma organizada. Como en este ejemplo:

Panel de Knowledge de Bill Gates

Panel de Knowledge de Bill Gates

Puedes entrar al Playground de JSON-LD para que conozcas todos los tipos que existen, entre ellos:

  • Person
  • Event
  • Product

Agregar JSON-LD a nuestras webs

El JSON-LD puede ir en cualquier parte del documento HTML, pero la mejor práctica es colocarlo dentro de la etiqueta <head>.

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <title>Título de tu página</title>
  
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "WebSite",
    "url": "https://tuweb.com/",
    "name": "Nombre de tu Sitio"
  }
  </script>
</head>
<body>
</body>    
</html>

Si usas frameworks modernos o CMS, no tienes que escribirlo a mano. Por ejemplo Next.js tiene una guía de como implementar JSON-LD: https://nextjs.org/docs/app/guides/json-ld.

Herramientas útiles

Puedes hacer uso de Rich Results Test (Google), el cual es ideal para ver si el JSON-LD se generará correctamente.

Análisis de mi web con Rich Results Test

Análisis de mi web con Rich Results Test

Comparte este artículo en

Avatar byandrev

Andres Parra

Software Engineer

Soy Andrés Parra, Ingeniero de Software apasionado por crear soluciones tecnológicas escalables e innovadoras. Me especializo en la construcción de aplicaciones web modernas, dominando un stack versátil que incluye JavaScript, TypeScript, Python y Java, junto con frameworks como React, Next.js y Spring Boot. Interesado en las últimas tecnologías y herramientas de desarrollo.