Qué es JSON-LD: el lenguaje que habla tu sitio con ChatGPT y Google
JSON-LD es el formato de schema markup preferido por Google, y el que mejor leen ChatGPT, Gemini y Perplexity. Sin él, los bots de IA interpretan tu sitio web como texto plano, y adivinan quién eres.
Cómo se ve un JSON-LD básico para una empresa
Va en el <head> del HTML. No lo ve el visitante. Lo leen Google, ChatGPT y Gemini.
Los tipos de JSON-LD más usados por Gerentia
¿JSON-LD, microdatos o RDFa? Las tres formas de marcar lo mismo
Hay tres maneras de escribir el mismo dato para que una máquina lo entienda, y la pregunta aparece medida: al medir el autocompletado de Google en Chile el 26 de agosto de 2026, «json ld vs xml», «json ld vs microdata» y «json ld vs json» están entre las frases que más se repiten de las 242 que devolvió.
| Formato | Dónde vive | Qué pasa al cambiar el diseño |
|---|---|---|
| JSON-LD | En un bloque aparte, al final del código | No se rompe: el dato no está pegado al diseño |
| Microdatos | Adentro de cada etiqueta visible | Se rompe seguido, porque el dato viaja con el HTML |
| RDFa | Adentro de cada etiqueta, con otra sintaxis | Igual de frágil y menos usado |
- Google recomienda JSON-LD de forma explícita en su documentación para desarrolladores
- Se puede agregar sin tocar una sola línea del diseño existente
- Un editor que reordene la página no lo desarma
- Se valida en segundos con la prueba de resultados enriquecidos de Google
- Es el formato en el que están escritos los marcados de este sitio
La diferencia práctica se ve el día que alguien cambia la plantilla: con microdatos, el marcado se va con el diseño; con JSON-LD, se queda. Por eso es el que usamos en todo lo que construimos.
Un caso con fecha: lo que encontramos al medir ocho competidores
El 20 de agosto de 2026 corrimos nuestro motor sobre las ocho casas chilenas que salen primero cuando alguien busca posicionamiento en inteligencia artificial. El marcado se lee desde afuera, sin pedirle permiso a nadie, así que el ejercicio se puede repetir hoy sobre cualquier dominio, incluido el nuestro.
| Qué se midió | Resultado |
|---|---|
| Sin una sola pregunta marcada en la portada | 4 de 8 |
| Con la ficha de negocio local marcada | 6 de 8 |
| La mejor de las ocho, en comprobaciones | 23 de 29 |
| Mostraba preguntas en pantalla sin marcarlas | 1 de 8 |
El último caso es el más caro y el más común: las preguntas están escritas para la persona y no existen para la máquina. Y hay una regla dura que se rompe seguido: declarar ocho preguntas y mostrar siete bota el resultado enriquecido de la página completa, no una parte de ella.
El error que bota la página entera
Hay una regla que casi todos rompen alguna vez y se paga cara: lo que está declarado en el JSON-LD tiene que estar visible en la misma página, con el mismo texto. Parecerse no alcanza: tiene que decir lo mismo, palabra por palabra.
Declarar ocho preguntas frecuentes y mostrar siete en pantalla no descuenta una. Bota el resultado enriquecido de la página completa, y la página sigue apareciendo pero sin nada que la distinga en la lista.
Lo sabemos porque nos pasó. El 13 de agosto de 2026 nuestro propio arnés encontró cinco comprobaciones rojas en gerentia.cl, y una de ellas era exactamente esto: un bloque que declaraba ocho preguntas con siete visibles. El 19 de agosto aparecieron seis más, entre ellas que el schema y la pantalla eran dos listas distintas de preguntas. Ninguna de las once se había visto antes de correr la herramienta.
La lección práctica es que el marcado y el contenido tienen que salir de la misma fuente. En este sitio las preguntas que se pintan en pantalla y las que se declaran en el código son la misma lista, leída una sola vez. Dos listas separadas dicen cosas distintas en dos semanas, y nadie se entera hasta que un cliente pregunta por qué no aparece.
Para seguir
Preguntas frecuentes
¿El JSON-LD tiene que coincidir con lo que se ve en la página?
Sí, y es la regla que más se rompe. Lo declarado en el código tiene que estar visible en la misma página y con el mismo texto. Declarar ocho preguntas frecuentes y mostrar siete no descuenta una: bota el resultado enriquecido de la página completa. Lo hemos visto en nuestro propio sitio y por eso lo mide una herramienta todos los días.
¿JSON-LD o microdatos, cuál conviene?
JSON-LD, y Google lo recomienda de forma explícita en su documentación. La razón práctica es que vive en un bloque aparte del código: se puede agregar sin tocar el diseño y no se rompe el día que alguien cambia la plantilla. Los microdatos van pegados a cada etiqueta visible y se desarman con cualquier cambio.
¿Cómo compruebo que mi JSON-LD quedó bien?
Con la prueba de resultados enriquecidos de Google y mirando el código servido de la página. Hay una trampa que conviene saber: si el marcado lo inyecta JavaScript, no aparece en el HTML que llega primero y una herramienta que no ejecute scripts lo marca como ausente aunque exista. Cuando el resultado da negativo, lo confirmamos con navegador.
¿Cuántos tipos de schema necesita una empresa?
Los que correspondan a lo que es y a lo que vende, no todos los que existan. Casi siempre son tres: la organización o el negocio local, las preguntas frecuentes y el servicio. Declarar tipos que no aplican no suma y agrega una forma más de equivocarse.
¿Qué es JSON-LD?
JSON-LD (JavaScript Object Notation for Linked Data) es el formato recomendado por Google para implementar schema markup. Es un bloque de código que se agrega al HTML del sitio dentro de una etiqueta script. No es visible para el visitante: solo lo leen los motores de búsqueda y los bots de IA. Google, ChatGPT, Gemini y Perplexity usan JSON-LD para entender qué tipo de entidad es un sitio web.
¿Por qué Google prefiere JSON-LD sobre otros formatos de schema?
Google recomienda JSON-LD porque es más fácil de implementar y mantener que Microdata o RDFa. JSON-LD va en un bloque separado del HTML: no hay que modificar la estructura de la página. Los bots de IA también lo prefieren porque es más fácil de parsear con precisión.
¿Necesito saber programar para implementar JSON-LD en mi sitio?
No necesariamente. En WordPress existen plugins (Yoast, RankMath, Schema Pro) que generan JSON-LD automáticamente. En Shopify y Jumpseller, algunos temas lo incluyen parcialmente. Gerentia implementa JSON-LD personalizado para cualquier plataforma, incluyendo los tipos de schema específicos para cada rubro.
¿Tu sitio tiene JSON-LD implementado correctamente?
Gerentia audita e implementa JSON-LD como parte del diagnóstico AEO.
Quiero el diagnóstico