JSON-LD: qué es, qué tipos de schema siguen importando y cómo implementarlo

¿Qué es JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) es una forma de describir el contenido de una página en un formato legible por máquinas, dentro de un único bloque <script type="application/ld+json"> en el HTML de la página. El bloque es invisible para quien visita la web. Las máquinas lo leen en vez de tener que adivinar qué significa la página a partir del diseño y los estilos.

Tres propiedades explican por qué se impuso. Es independiente: el marcado vive en un único bloque, no repartido por tu HTML como en los formatos más antiguos, microdatos y RDFa, así que se puede plantillar y mantener sin tocar la página visible. Es explícito: "priceCurrency": "EUR" no deja nada a la interpretación. Y es el formato recomendado: Google lleva años señalando JSON-LD como su sintaxis preferida para el dato estructurado, y prácticamente todas las herramientas modernas lo dan por hecho.

¿Qué es schema.org y cómo se relaciona con JSON-LD?

Schema.org es el vocabulario; JSON-LD es la gramática. Schema.org es un diccionario compartido de tipos (Product, Organization, Article, FAQPage…) y propiedades (price, logo, author…) en los que las máquinas se ponen de acuerdo, fundado en 2011 por Google, Microsoft, Yahoo y Yandex precisamente para que la web no necesitara un dialecto distinto por cada buscador. JSON-LD es el formato en el que escribes ese vocabulario.

El diccionario es enorme (unos 800 tipos), y esa escala engaña. Solo un pequeño subconjunto activa alguna función visible en la búsqueda, y nada te obliga a usar el resto. El oficio está en elegir el puñado de tipos que las máquinas consumen de forma demostrable, e implementarlos bien.

¿Por qué sigue importando el dato estructurado en 2026?

Porque lo leen tres públicos distintos de máquinas, y cada uno paga de una forma distinta.

Los resultados enriquecidos y las fichas de comerciante de Google. El marcado correcto hace que las páginas sean aptas para apariciones mejoradas en la búsqueda: fragmentos de producto con precio, disponibilidad y valoraciones con estrellas, cabeceras de artículo, rutas de migas de pan y, para las tiendas, las fichas de comerciante gratuitas de Google, donde los datos del producto (incluidos gastos de envío y devoluciones) se extraen directamente del marcado. Aptitud, no garantía: Google decide en cada búsqueda qué mostrar. Pero los resultados con datos enriquecidos destacan a la vista, y esa ventaja de clics no la ha retirado nadie.

El ecosistema de IA en general. Microsoft, a través de su product manager principal Fabrice Canel, declaró en marzo de 2025 que el marcado de schema ayuda a sus modelos de lenguaje a entender el contenido web, lo que alimenta a Bing y Copilot. Google, por su parte, afirmó en mayo de 2026 que el dato estructurado no es necesario para los resúmenes de IA ni para el modo IA. Y un estudio de Ahrefs sobre 1.885 páginas que añadieron JSON-LD no encontró ningún cambio relevante en la frecuencia con la que los sistemas de IA las citaban. La síntesis honesta: el dato estructurado no hace que los sistemas de IA te citen (eso lo hace el contenido), pero elimina la ambigüedad sobre lo que dicen tus páginas, para cualquier máquina que lea el HTML en bruto. Es un seguro barato de desambiguación, no una palanca de crecimiento. La misma lógica aparece en nuestra guía sobre llms.txt: describe tu sitio a las máquinas sin prometer más citas de IA.

El grafo de conocimiento: las máquinas aprenden quién eres. Un bloque Organization con enlaces sameAs que apunten a tu ficha de Wikidata, tu página de Wikipedia y tus perfiles oficiales ayuda a las máquinas a conectar tu dominio con una entidad inequívoca. Esa capa de identidad importa cada año más: cuando un asistente de IA tiene que decidir si «Example Store» en un hilo de un foro eres tú o una tienda homónima, los datos de la entidad son lo primero a lo que recurre. Profundizamos en cómo funciona esto en nuestra guía sobre el grafo de conocimiento y Wikidata.

¿Qué tipos de schema sigue premiando Google y cuáles se han retirado?

La lista activa es más corta de lo que admiten la mayoría de las guías, porque Google lleva de 2023 a 2026 podándola. Esto es lo que queda, y lo que aporta:

Y el registro de bajas: marcado que ya no activa nada visible en Google:

Dos matices mantienen esta tabla honesta. El marcado retirado no se penaliza: Google simplemente lo ignora, y los tipos no admitidos no generan errores. Y que se retire la recompensa visual no significa que se retire el significado del marcado: el marcado FAQPage sigue etiquetando tus preguntas y respuestas para cualquier otra máquina que lea tu HTML, por eso seguimos recomendándolo como paso final después de escribir contenido de preguntas y respuestas genuino, un argumento que desarrollamos con detalle en nuestro artículo sobre el marcado FAQ.

¿Qué tipos debería priorizar una tienda online?

En orden de rendimiento por esfuerzo:

1. `Product` con un `Offer` completo. El núcleo comercial: nombre, imagen, descripción, marca, GTIN, precio, moneda, disponibilidad, más los gastos de envío y la política de devoluciones (OfferShippingDetails, MerchantReturnPolicy), que las fichas de comerciante de Google muestran directamente. Las tiendas con datos de producto en el marcado compiten en superficies en las que las tiendas sin marcar directamente no aparecen.
2. `Organization` con `sameAs`. Un único bloque, para todo el sitio, que enlaza tu nombre, tu logo y tus perfiles oficiales, incluida tu entidad de Wikidata si existe. Es el trabajo más barato que puedes hacer por tu identidad legible por máquinas.
3. `BreadcrumbList`. Trivial de implementar, se muestra en los resultados y regala a las máquinas la jerarquía de tu sitio.
4. `FAQPage` en páginas de producto, envío y servicio. Ya no da estrellas en Google, pero etiqueta tu contenido más citable para el resto del ecosistema, y escribirlo te obliga a dar forma de respuesta a tu contenido.
5. `Article` en tus guías y artículos. Ganancias modestas, coste casi nulo una vez que lo plantillas.
6. `LocalBusiness`, si tienes tiendas físicas. Horario, dirección y coordenadas para la búsqueda local.

¿Cómo se implementa JSON-LD en la práctica?

1. Audita lo que ya tienes. La mayoría de las plataformas (Shopify, WooCommerce, Wix y el resto) generan algo de JSON-LD de fábrica, y los plugins de SEO añaden más. Pasa las páginas clave por validator.schema.org antes de añadir nada: el error más habitual en las tiendas grandes es tener tres plugins generando tres bloques Product que se contradicen.
2. Trabaja por plantilla, no por página. Decide qué tipos corresponden a cada plantilla de página (ficha de producto, categoría, artículo, contacto) y genera el marcado a partir de los mismos datos que pintan la página visible. El JSON-LD escrito a mano se queda desactualizado; el JSON-LD plantillado no puede.
3. Refleja exactamente el contenido visible. El marcado describe lo que hay en la página: el mismo precio, las mismas afirmaciones. Marcar contenido que quien visita no puede ver incumple las directrices de Google y es el camino clásico hacia una acción manual.
4. Conecta tus entidades. Da a tu Organization de todo el sitio un @id y referéncialo desde los productos (brand, publisher) para que las máquinas vean un grafo conectado en vez de fragmentos sueltos.
5. Valida dos veces. validator.schema.org comprueba el vocabulario; el Rich Results Test de Google comprueba si eres apto para sus propias funciones. Los dos son gratis y tardan segundos.
6. Vigílalo en Search Console. Los informes de mejoras muestran qué páginas tienen marcado válido, inválido o ausente, y te avisan cuando un cambio de plantilla lo rompe en silencio.
7. Mantenlo vivo. El precio y la disponibilidad cambian constantemente, por eso importa el paso 2. Un bloque JSON-LD que afirma un precio antiguo es peor que no tener ninguno: es un dato erróneo servido con la confianza de una máquina.

¿Cómo es un JSON-LD correcto?

Dos ejemplos compactos y realistas. Primero, el bloque de identidad para todo el sitio:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example-store.com/#organization",
  "name": "Example Store",
  "url": "https://www.example-store.com/",
  "logo": "https://www.example-store.com/logo.png",
  "sameAs": [
    "https://www.wikidata.org/wiki/Q00000000",
    "https://www.instagram.com/examplestore",
    "https://www.linkedin.com/company/example-store"
  ]
}

Segundo, una página de producto con los datos de oferta que consumen las fichas de comerciante:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Ridgeline Trail Shoe",
  "image": "https://www.example-store.com/img/ridgeline-trail.jpg",
  "description": "Lightweight trail-running shoe with a 6 mm drop and a grippy outsole, built for wet terrain.",
  "brand": { "@type": "Brand", "name": "Ridgeline" },
  "gtin13": "5701234567890",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "214"
  },
  "offers": {
    "@type": "Offer",
    "price": "129.00",
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": { "@type": "MonetaryAmount", "value": "4.90", "currency": "EUR" },
      "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "DE" }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "DE",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}

Fíjate en qué hace que estos ejemplos sean correctos y no decorativos: cada valor refleja algo visible en la página, la valoración existe solo porque las reseñas se muestran ahí, y los identificadores (gtin13, @id) son los enganches que otros sistemas usan para relacionar este producto y esta empresa en toda la web.

¿Cuáles son los errores más comunes con JSON-LD?

• Marcar contenido que no está en la página: valoraciones aspiracionales, FAQ invisibles. Incumple las directrices, es un riesgo de spam y no aporta nada.
• Duplicados contradictorios de la plataforma, el plugin y el tema, todos generando marcado a la vez. Las máquinas se encuentran tres precios distintos y no se fían de ninguno.
• Datos desactualizados: marcado que afirma el precio de la temporada pasada porque se escribió a mano una vez y se olvidó.
• Errores de sintaxis: una coma sobrante invalida en silencio todo el bloque. Por eso la validación debe formar parte del flujo de trabajo, no ser cosa de la semana de lanzamiento.
• Esfuerzo huérfano: implementar tipos exóticos que nadie consume mientras Product sigue sin GTIN ni datos de envío.
• Esperar una subida en el posicionamiento. El dato estructurado no es un factor de posicionamiento. Cambia cómo apareces y lo que saben las máquinas, no en qué puesto sales.

Reflexión final

El dato estructurado en 2026 exige más cabeza fría que la que suele traer el ciclo de hype a su alrededor. Google ha retirado las estrellas de FAQ, los paneles de how-to y media docena de recompensas más, y aun así el marcado de producto impulsa visibilidad real en las fichas de comerciante, el marcado de entidad alimenta el grafo de conocimiento, y cualquier rastreador de IA que lea tu HTML en bruto se encuentra con tu JSON-LD antes que con tu prosa. En nuestra auditoría de agosto de 2026 sobre 99 tiendas online (en noruego), el 56 % de los sitios legibles no tenía ningún JSON-LD, y 12 de 99 carecían a la vez de dato estructurado, entidad de Wikidata y cualquier señal para agentes: invisibles para las máquinas en todas las métricas que medimos.

Así que la oportunidad es la misma que recorre todo lo que publicamos: el suelo está vacío. Escribe páginas que merezca la pena describir, y descríbelas con precisión: datos de producto completos, identidad conectada, marcado que refleja lo visible. Esto no hará que las máquinas te quieran. Hará que, cuando te lean, te entiendan bien, y ahora mismo, eso solo ya te pone por delante de medio mercado. Como explicamos en nuestra guía sobre SEO, AEO, GEO y AIO, lo técnico es el suelo; la autoridad y las menciones independientes son las que deciden si te citan.