Guía

Qué es JSON-LD y cómo añadirlo

Una IA que lee tu página tiene que adivinar qué eres a partir del texto. Los datos estructurados eliminan esa adivinanza: le dicen, en un formato que entiende, "esto es una Organización, esto un Producto, esto una FAQ". JSON-LD es la forma recomendada de declararlos. No requiere rediseñar tu web ni saber programar: es un bloque de texto en el <head>.

1. Entiende qué es JSON-LD

JSON-LD (JSON for Linking Data) es un pequeño bloque de datos en formato JSON que describe tu página con el vocabulario de schema.org. Va aparte de tu HTML visible, así que no cambia el diseño: solo añade una capa de significado legible por máquinas.

2. Sabe por qué se prefiere frente a otros formatos

Existen microdata y RDFa, que mezclan las etiquetas dentro del HTML. JSON-LD se recomienda porque va en un solo bloque separado: más fácil de añadir, de mantener y de no romper cuando rediseñas. Es también el formato que Google recomienda.

3. Colócalo en el <head> de tu página

Se añade dentro de una etiqueta <script type="application/ld+json"> … </script>, normalmente en el <head>. Los crawlers de IA lo leen directamente del HTML crudo, sin ejecutar JavaScript, así que la señal llega intacta.

4. Elige el @type que te describe

schema.org tiene un tipo para casi todo: Organization (tu empresa), LocalBusiness (negocio con dirección física), Product (un producto), Article (un artículo o post), FAQPage (preguntas frecuentes), BreadcrumbList (migas de navegación). Empieza por el que mejor describa la página.

5. Rellena las propiedades clave

Para una Organization: name, url, logo, description y sameAs (enlaces a tus redes). Para un Product: name, description, brand y offers con price y priceCurrency. Cuantas más propiedades reales rellenes, menos tiene que adivinar la IA.

6. Mantén el JSON-LD sincronizado con lo visible

Los datos estructurados deben coincidir con lo que ve el usuario en la página. Declarar precios, valoraciones o datos que no aparecen en el contenido visible es contraproducente: rompe la confianza y algunos sistemas lo penalizan. Declara lo verdadero.

7. Valida antes de publicar

Usa un validador de schema (por ejemplo el Schema Markup Validator o el test de resultados enriquecidos de Google) para confirmar que tu JSON-LD no tiene errores de sintaxis ni tipos mal escritos. Un bloque con un error puede ignorarse por completo.

8. Genera el tuyo desde tu contenido real

No hace falta escribirlo a mano desde cero: al escanear tu dominio te entregamos un bloque JSON-LD de Organization listo para copiar y pegar, derivado de tu página real, como punto de partida.

Mira si tu web ya declara datos estructurados y obtén un bloque JSON-LD listo para pegar: escanea tu dominio gratis y recibe tu Puntuación de Visibilidad IA con el arreglo concreto de cada señal.

FAQ

¿JSON-LD me hace posicionar mejor?

No directamente. JSON-LD no es un factor mágico de ranking: es la forma de declarar sin ambigüedad qué eres, para que las IAs y los buscadores te entiendan y puedan citarte con precisión. Es una precondición de la comprensión, no una palanca de posición.

¿Necesito saber programar para añadirlo?

No. Es un bloque de texto que pegas en el <head> de tu página. Muchos CMS y plugins lo generan por ti; también te damos un borrador al escanear.

¿Qué @type debo elegir?

El que mejor describa la página: Organization para tu identidad, LocalBusiness si tienes local físico, Product para una ficha de producto, Article para un post, FAQPage para preguntas frecuentes. Puedes combinar varios.

¿Puedo tener más de un bloque JSON-LD?

Sí. Es normal tener varios: uno de Organization en toda la web y otro específico por página (Product, Article, FAQPage). Solo asegúrate de que cada uno sea válido y coincida con el contenido visible.