Glosario

¿Qué son los datos estructurados JSON-LD?

8 de febrero de 2026 Actualizado el 19 abr 2026

JSON-LD (JavaScript Object Notation for Linked Data) es un formato de datos estructurados que ayuda a los buscadores a entender de qué tratan realmente tus páginas. En lugar de adivinarlo solo a partir de tu contenido HTML, los buscadores pueden leer un bloque JSON-LD y saber exactamente si una página describe una receta, un producto, un negocio local o un artículo de noticias. El formato utiliza un bloque <script type="application/ld+json"> incrustado en tu HTML, invisible para los visitantes pero perfectamente legible por las máquinas.

Qué le dicen los datos estructurados a los buscadores

Piensa en los datos estructurados como una capa de traducción entre tu web y Google. Tu página puede mencionar "49,99" en algún sitio del texto, pero sin datos estructurados Google no tiene forma de saber si eso es un precio, una valoración o un número aleatorio. JSON-LD elimina esa ambigüedad envolviendo tu contenido en campos claramente etiquetados que siguen el vocabulario de Schema.org.

Google utiliza esta información con varios propósitos:

  • Rich snippets: resultados de búsqueda mejorados que muestran valoraciones con estrellas, precios, tiempos de cocción, respuestas de FAQ o fechas de eventos directamente en la página de resultados. Destacan visualmente frente a los listados normales y suelen atraer más clics.
  • Knowledge Graph: cuando Google construye esos paneles informativos a la derecha de los resultados de búsqueda (sobre empresas, personas o lugares), los datos estructurados son una de las fuentes clave de las que se nutre.
  • Búsqueda por voz y asistentes: Google Assistant y herramientas similares extraen respuestas de los datos estructurados. Si tu página de FAQ tiene un marcado JSON-LD adecuado, tus respuestas podrían leerse en voz alta a los usuarios.
  • Listados de Google Shopping y Merchant: los datos estructurados de productos pueden alimentar listados gratuitos en los resultados de Google Shopping, dándote visibilidad sin pagar anuncios.

JSON-LD vs. Microdatos vs. RDFa

Hay tres formas de añadir datos estructurados a una página, y todas persiguen el mismo objetivo, pero funcionan de forma muy distinta en la práctica:

  • JSON-LD: un bloque de script independiente, normalmente colocado en el <head> o al final del <body>. No toca tu marcado HTML. Puedes añadirlo, modificarlo o quitarlo sin afectar el aspecto visual de tu página. Google recomienda oficialmente este formato.
  • Microdatos: atributos añadidos directamente a tus elementos HTML (itemscope, itemprop, etc.). Esto significa que tus datos estructurados se entrelazan con el código de tu plantilla, lo que dificulta el mantenimiento y aumenta el riesgo de romperse al cambiar de plantilla.
  • RDFa: similar a los microdatos en cuanto a que utiliza atributos HTML, pero sigue una especificación diferente. Es más común en contextos no relacionados con Google y los plugins de WordPress lo soportan menos.

Para los sitios WordPress, JSON-LD es claramente el ganador. Mantiene tus plantillas limpias, funciona bien con plugins de caché y se puede generar dinámicamente desde PHP sin alterar los archivos de la plantilla.

Tipos comunes de Schema.org para sitios WordPress

Schema.org define cientos de tipos, pero solo unos pocos son habitualmente relevantes para sitios WordPress. Estos son los que te encontrarás con más frecuencia:

  • Article / BlogPosting: se usa en entradas de blog y artículos de noticias. Incluye titular, autor, fecha de publicación e imagen destacada. Es el tipo más común en sitios WordPress y puede activar resultados enriquecidos tipo artículo en Google.
  • FAQPage: marca páginas con contenido de preguntas y respuestas. Cuando Google lo detecta, puede mostrar fragmentos de FAQ desplegables directamente en los resultados, lo que puede aumentar significativamente el espacio que ocupa tu listado.
  • HowTo: para contenido tipo tutorial paso a paso. Google puede mostrar los pasos individuales en los resultados de búsqueda, a veces con imágenes para cada paso.
  • Product: esencial para tiendas WooCommerce. Incluye precio, disponibilidad, reseñas y marca. Es lo que habilita los resultados enriquecidos de tipo producto con precios y valoraciones con estrellas.
  • LocalBusiness: para negocios con ubicación física. Incluye dirección, horario de apertura, número de teléfono y coordenadas geográficas. Esto alimenta Google Maps y los resultados de búsqueda local.
  • BreadcrumbList: describe la ruta de navegación hasta la página actual. Google lo usa para mostrar enlaces de migas de pan en los resultados de búsqueda en lugar de la URL en bruto, lo que se ve más limpio y ayuda a los usuarios a entender la estructura de tu sitio.
  • WebSite: colocado en la página de inicio, este tipo puede habilitar el cuadro de búsqueda de sitelinks en Google, permitiendo a los usuarios buscar en tu sitio directamente desde la página de resultados.

Cómo generan JSON-LD los plugins SEO de WordPress

La mayoría de los propietarios de sitios WordPress no escriben JSON-LD a mano. En su lugar, los plugins SEO lo gestionan automáticamente:

  • Yoast SEO: genera un grafo JSON-LD completo en cada página, incluyendo los tipos WebSite, WebPage, Organization (o Person), Article y BreadcrumbList. Yoast construye un grafo conectado en el que todas las entidades se referencian entre sí, lo que da a Google una imagen completa de tu sitio.
  • Rank Math: ofrece una generación automática similar y además proporciona una interfaz para añadir tipos de schema personalizados a entradas individuales. Puedes marcar una entrada como Receta, Evento o Curso sin escribir código.
  • Schema Pro y otros plugins dedicados: si necesitas un control más granular (por ejemplo, añadir varios tipos de schema a una misma página o gestionar estructuras anidadas complejas), los plugins de schema dedicados te dan esa flexibilidad.

Algo importante a tener en cuenta: no uses varios plugins que generen JSON-LD a la vez. Los datos estructurados duplicados o conflictivos confunden a los buscadores y pueden hacer que no se muestre ninguno de tus rich snippets.

Un ejemplo práctico de JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "What is JSON-LD?",
  "author": {
    "@type": "Person",
    "name": "John Doe"
  },
  "datePublished": "2025-01-15",
  "dateModified": "2025-03-10",
  "publisher": {
    "@type": "Organization",
    "name": "Example Site",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "image": "https://example.com/article-image.jpg",
  "description": "A comprehensive guide to JSON-LD structured data."
}

Fíjate en cómo todo es autocontenido en un único bloque. Podrías pegar esto en cualquier página sin modificar ni un solo elemento HTML, y los buscadores entenderían inmediatamente que la página describe un artículo escrito por John Doe.

Probar y validar tus datos estructurados

Antes de confiar en tus datos estructurados para generar resultados enriquecidos, deberías validarlos. Google ofrece dos herramientas para esto:

  • Prueba de resultados enriquecidos (search.google.com/test/rich-results): introduce una URL o pega tu código y Google te muestra qué tipos de resultados enriquecidos son elegibles y si hay errores o advertencias.
  • Validador de marcado de Schema (validator.schema.org): un validador más general que comprueba tu marcado contra la especificación completa de Schema.org, no solo el subconjunto que admite Google.

Ejecuta estas comprobaciones después de cambiar la configuración de tu plugin SEO o tras cambiar de plantilla. Los cambios de plantilla pueden a veces eliminar o duplicar bloques de datos estructurados.

Impacto en la tasa de clics

El beneficio práctico de los datos estructurados es una mejor visibilidad en los resultados de búsqueda. Las páginas con rich snippets ocupan más espacio visual en la página de resultados y proporcionan más información de un vistazo. Estudios e informes del sector muestran de forma consistente que los resultados enriquecidos pueden aumentar la tasa de clics entre un 20 y un 30 por ciento en comparación con los listados normales. Los snippets de FAQ, en particular, pueden duplicar la altura de tu resultado de búsqueda, empujando a la competencia más abajo en la página. Aunque tu posición no cambie, una mayor presencia visual significa más clics.

Dicho esto, Google no garantiza resultados enriquecidos para todas las páginas con datos estructurados. Depende de la calidad de tu contenido, de si Google considera tu marcado fiable y de lo competitiva que sea la consulta de búsqueda.

Qué comprueba InspectWP

InspectWP analiza tu sitio WordPress en busca de bloques de datos estructurados JSON-LD e informa qué tipos de Schema.org están presentes. Comprueba si tus páginas incluyen los tipos más comunes (Article, BreadcrumbList, WebSite) y señala las páginas donde faltan completamente los datos estructurados. Esto te ayuda a identificar lagunas en tu marcado y a asegurarte de que tu plugin SEO genera la salida correcta en todo tu sitio.

Analiza tu sitio de WordPress ahora

InspectWP analiza tu sitio de WordPress en busca de problemas de seguridad, SEO, cumplimiento del RGPD y rendimiento, gratis.

Analiza tu sitio gratis