Si tienes una web y no sabes qué es el JSON-LD, no te preocupes. No es culpa tuya. Es culpa de todas las agencias y diseñadores web que te entregaron tu proyecto sin mencionarlo ni una vez.
Y también es, en parte, la razón por la que tu web no está rindiendo todo lo que podría.
En este artículo te voy a explicar qué es el JSON-LD desde cero (sin asumir que sabes nada de código), por qué Google y las inteligencias artificiales lo adoran, y cómo implementarlo paso a paso con ejemplos reales y listos para copiar.
Al final del artículo tendrás cuatro fragmentos de código funcionales que puedes añadir a tu web hoy mismo. Prometido.
💡 Nota: Si ya tienes claro qué es el JSON-LD y quieres entender cómo afecta a la visibilidad de tu negocio en Valencia frente a las IAs, lee también este artículo:
Empecemos por el principio: ¿qué ve Google cuando entra a tu web?
Tú ves tu web así: un diseño bonito, textos bien redactados, fotos, tu logo, tus servicios explicados con cariño.
Google la ve así:
<div class="hero-section">
<h1>Bienvenidos a nuestro estudio</h1>
<p>Somos especialistas en...</p>
</div>
Es decir: Google ve código HTML. Y aunque Google es muy listo y lleva años aprendiendo a interpretar ese código, sigue teniendo un problema fundamental: tiene que adivinar muchas cosas.
- ¿Este negocio está en Valencia o en Barcelona? A ver, en el texto de contacto pone «Valencia»… creo.
- ¿Qué servicios ofrece exactamente? Pone «consultoría», pero ¿de qué tipo?
- ¿Es un negocio de confianza? Tiene reseñas, pero no sé cuántas ni cuál es la valoración media.
Cada vez que Google tiene que adivinar, hay margen para el error. Y el error, en SEO, significa que no apareces cuando deberías aparecer.
El JSON-LD elimina las conjeturas. Le hablas a Google en su idioma nativo y le dices exactamente lo que necesita saber, sin ambigüedad.
Vale, pero
¿qué es el JSON-LD exactamente?
JSON-LD son las siglas de JavaScript Object Notation for Linked Data. Sé que suena intimidante. Vamos a descomponerlo:
- JSON es un formato para organizar información de forma estructurada. Piensa en él como una ficha bien ordenada.
- Linked Data significa que esa información está conectada a un vocabulario compartido que Google, Bing y las IAs reconocen universalmente: schema.org.
En la práctica, el JSON-LD es un bloque de código que vive en el <head> de tu web, invisible para tus visitantes pero completamente legible para los motores de búsqueda. No afecta al diseño, no ralentiza la web, y no requiere tocar nada de lo que ya tienes.
Lo que hace es declarar, de forma inequívoca: «Este es mi negocio, esto es lo que hace, aquí está, y esto es lo que dicen de él.»
La metáfora que uso siempre con mis clientes
Imagina que tu web es una tienda física en una calle de Valencia.
Sin JSON-LD, Google pasa por delante, mira el escaparate, y tiene que interpretar qué vendes, si estás abierto, si eres de fiar. Lo hace bien, pero no perfectamente.
Con JSON-LD, es como si tuvieras un cartel en la puerta con toda la información organizada: horario, servicios, valoraciones, teléfono, años en el mercado. Google no tiene que interpretar nada. Lo lee, lo entiende, y te posiciona en consecuencia.
¿Por qué importa especialmente ahora, en 2025?
El JSON-LD siempre ha sido importante para el SEO. Pero en 2025 tiene una segunda razón de peso para implementarlo: la búsqueda generativa.
Cuando alguien pregunta a ChatGPT, Perplexity o Gemini «¿cuál es el mejor despacho de abogados en Valencia?», esas IAs rastrean la web y construyen su respuesta basándose en la información que pueden comprender con certeza.
Un negocio con JSON-LD bien implementado es, para una IA, una entidad reconocible y fiable. Uno sin él es ruido de fondo.
No es exageración: el JSON-LD es hoy el pasaporte de tu negocio para aparecer en las recomendaciones de la IA.
Los 4 tipos de schema que todo negocio debería tener
Vamos a la parte práctica. Te explico qué hace cada uno y te doy el código listo para usar.
1. LocalBusiness — Tu ficha de identidad
Es el más importante si tienes un negocio local. Le dice a Google quién eres, dónde estás, cómo contactarte y qué opinan tus clientes.
¿Cuándo usarlo? Siempre. Es la base de todo.
<script type="application/ld+json">{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Tu Negocio SL",
"description": "Descripción clara de tu negocio con tu keyword principal integrada de forma natural. Máximo 2-3 frases.",
"url": "https://www.tunegocio.es",
"logo": "https://www.tunegocio.es/wp-content/uploads/logo.png",
"image": "https://www.tunegocio.es/wp-content/uploads/foto-negocio.jpg",
"telephone": "+34 600 000 000",
"email": "hola@tunegocio.es",
"foundingDate": "2018",
"address": {
"@type": "PostalAddress",
"streetAddress": "Calle de ejemplo, 42",
"addressLocality": "Valencia",
"addressRegion": "Comunitat Valenciana",
"postalCode": "46001",
"addressCountry": "ES"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": 39.4699,
"longitude": -0.3763
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "09:00",
"closes": "18:00"
}
],
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.9",
"reviewCount": "47"
},
"sameAs": [
"https://www.instagram.com/tunegocio",
"https://www.linkedin.com/company/tunegocio",
"https://g.page/tunegocio"
],
"priceRange": "€€"
}</script>
Campos que no puedes saltarte:
- foundingDate: le da contexto de antigüedad y confianza al negocio.
- aggregateRating: tus reseñas de Google en formato estructurado. Si tienes 25 reseñas con 5 estrellas, que Google lo sepa sin tener que buscarlo.
- sameAs: conecta tu web con todos tus perfiles online. Esto es fundamental para que Google y las IAs te reconozcan como una sola entidad consistente, no como varios negocios distintos con nombres parecidos.
2. Service — Lo que ofreces, sin lugar a dudas
El LocalBusiness dice quién eres. El Service dice qué vendes. Son complementarios, no excluyentes, y puedes tener tantos bloques Service como servicios tengas.
¿Cuándo usarlo? En las páginas de servicios individuales o en la home si ofreces varios.
<script type="application/ld+json">{
"@context": "https://schema.org",
"@type": "Service",
"name": "Consultoría SEO para negocios locales en Valencia",
"description": "Auditoría, estrategia y optimización SEO para negocios locales en Valencia que quieren aparecer en Google y en los nuevos motores de búsqueda con IA.",
"provider": {
"@type": "LocalBusiness",
"name": "Tu Negocio SL",
"url": "https://www.tunegocio.es"
},
"areaServed": {
"@type": "City",
"name": "Valencia"
},
"serviceType": "SEO Consulting",
"url": "https://www.tunegocio.es/servicios/consultoria-seo/",
"offers": {
"@type": "Offer",
"priceCurrency": "EUR",
"price": "Desde 350",
"availability": "https://schema.org/InStock"
}
}</script>
Lo más valioso de este schema: El campo areaServed es tu mejor aliado en SEO local. Le estás diciendo a Google exactamente en qué zona geográfica operas, lo que refuerza tu relevancia para búsquedas como «[servicio] en Valencia».
3. FAQPage — Tus preguntas frecuentes con superpoderes
Este es el schema que más resultados visuales genera en Google. Cuando está bien implementado, Google puede mostrar tus preguntas y respuestas directamente en los resultados de búsqueda (los llamados rich results), ocupando el doble de espacio en pantalla que un resultado normal.
¿Cuándo usarlo? En cualquier página que tenga una sección de preguntas frecuentes. También en artículos de blog donde respondas preguntas concretas.
<script type="application/ld+json">{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "¿Qué es el SEO técnico y por qué lo necesita mi negocio?",
"acceptedAnswer": {
"@type": "Answer",
"text": "El SEO técnico es el conjunto de optimizaciones que se aplican en el código y la estructura de una web para que Google pueda rastrearla, entenderla e indexarla correctamente. Sin una base técnica sólida, el resto del SEO (contenido, enlaces) no funciona al 100%."
}
},
{
"@type": "Question",
"name": "¿Cuánto tiempo tarda en notarse el SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Depende del punto de partida, la competencia del sector y el tipo de optimizaciones. En general, los primeros resultados visibles se suelen observar entre 2 y 4 meses. Las mejoras de SEO técnico como la velocidad o los datos estructurados pueden notarse antes."
}
},
{
"@type": "Question",
"name": "¿Necesito saber programar para implementar JSON-LD en WordPress?",
"acceptedAnswer": {
"@type": "Answer",
"text": "No. En WordPress puedes añadir JSON-LD a través del widget HTML personalizado de Elementor, del plugin Rank Math (que genera schema automáticamente), o pegando el código en el header de tu tema. No necesitas tocar el core de WordPress ni saber programar."
}
}
]
}</script>
Truco: Las respuestas del FAQPage también alimentan a las IAs generativas. Cuando alguien pregunta a ChatGPT algo relacionado con tu sector, una respuesta bien estructurada en tu FAQPage tiene más probabilidades de ser usada como fuente.
4. BreadcrumbList — La navegación que Google entiende
Las migas de pan (breadcrumbs) son esa navegación que aparece en la parte superior de muchas webs: Inicio > Blog > SEO técnico > Este artículo. El schema BreadcrumbList le comunica esa jerarquía a Google de forma estructurada.
¿Por qué importa? Porque Google puede mostrar esa ruta directamente en los resultados de búsqueda, haciendo que tu resultado sea más visual y ocupe más espacio. Y porque refuerza la arquitectura de tu web a ojos de Google.
¿Cuándo usarlo? En todas las páginas que tengan una jerarquía clara: páginas de categoría, posts de blog, páginas de servicios.
<script type="application/ld+json">{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Inicio",
"item": "https://www.tunegocio.es/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Blog SEO",
"item": "https://www.tunegocio.es/blog-seo/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Qué es el JSON-LD y por qué es lo más importante que puedes añadir a tu web",
"item": "https://www.tunegocio.es/blog-seo/que-es-json-ld/"
}
]
}</script>
Cómo implementar esto en WordPress (sin morir en el intento)
Tienes tres opciones, de más fácil a más controlada:
Opción A — Rank Math (la más rápida)
Rank Math genera automáticamente el schema de LocalBusiness y BreadcrumbList si lo configuras bien en Rank Math > Ajustes > Búsqueda local. Es un buen punto de partida, pero tiene limitaciones: no genera el schema de Service con el nivel de detalle que necesitas, y el FAQPage requiere que uses el bloque específico de Rank Math en el editor.
Opción B — Widget HTML de Elementor (la más flexible)
Añade un widget HTML en cualquier página y pega el código del schema dentro. Es invisible para el visitante pero perfectamente legible para Google. Esta es la opción que uso cuando necesito un control total sobre el schema sin depender de un plugin.
Opción C — Header del tema (la más limpia)
En Apariencia > Editor de temas > header.php (o a través de un plugin como Insert Headers and Footers), pegas el JSON-LD del LocalBusiness una sola vez y se aplica a toda la web. Para el schema específico de páginas o posts, combinas con la Opción B.
Mi recomendación:
Opción A para lo básico (LocalBusiness, breadcrumbs), Opción B para el Service y FAQPage en páginas concretas. Lo mejor de los dos mundos.
Cómo validar que tu JSON-LD está bien implementado
Antes de cerrar la pestaña, valida siempre el código. Google tiene una herramienta gratuita para esto:
Pegas la URL de tu página (o el código directamente) y te dice si el schema está bien formado, si hay errores, y si esa página es elegible para rich results en los resultados de búsqueda.
También puedes usar el Schema Markup Validator para una validación más técnica.
Errores más comunes que detecta la herramienta:
- Comillas tipográficas (
") en lugar de comillas rectas (") — pasa cuando copias desde Word o Google Docs. - Campos obligatorios vacíos o con el texto de ejemplo sin sustituir.
- URLs relativas (
/contacto) en lugar de absolutas (https://www.tunegocio.es/contacto).
Conclusión: el JSON-LD no es opcional en 2025
El JSON-LD lleva años siendo una recomendación de Google. Pero en el contexto actual, con la búsqueda generativa consolidándose como canal principal, ha pasado de ser una buena práctica a ser infraestructura básica.
No implementarlo hoy es como abrir una tienda sin poner el letrero en la puerta. Puedes tener el mejor producto del barrio, pero si nadie sabe que estás ahí, da igual.
La buena noticia es que implementarlo no es tan complejo como parece. Con los cuatro schemas de este artículo tienes cubierto el 80% de lo que necesita cualquier negocio local.
¿Quieres que revise el JSON-LD de tu web?
Si después de leer esto tienes dudas sobre si tu web tiene el schema correcto, si está bien implementado, o si hay errores que no estás viendo, escríbeme y lo miramos juntas.
Hago una revisión rápida del marcado estructurado de tu web y te digo exactamente qué está bien, qué falta y qué priorizar. Sin tecnicismos innecesarios, sin venderte lo que no necesitas.