
SEO técnico, formatos y estándares web
JSON-LD: qué es, cómo se escribe y ejemplo para negocios
Llámanos sin compromiso: 722 766 344
Definición
Qué significa JSON-LD: JavaScript Object Notation for Linked Data (JSON para datos enlazados).
¿Vas a crear una empresa?
Crea tu empresa o SL online en 24 horas por 290 € + IVA, con notaría y Registro incluidos (capital de 3.000 a 3.100 €). Asesoría personal de nuestros economistas y firma por videollamada.
Qué es JSON-LD
JSON-LD (JavaScript Object Notation for Linked Data, «JSON para datos enlazados») es un formato para escribir información de forma que las máquinas la entiendan y puedan relacionarla con otra. Es un estándar del W3C, el organismo que fija los estándares de la web, y su versión actual, la 1.1, es una recomendación oficial desde julio de 2020.
En SEO se usa para añadir datos estructurados a una página: un bloque de código, invisible para el visitante, que describe con el vocabulario de Schema.org qué contiene la página. Google lo recomienda frente a los otros dos formatos que admite (microdatos y RDFa) porque es el más sencillo de añadir y de mantener: va en un bloque aparte, no hay que tocar el HTML que ve el usuario y se puede generar desde una plantilla o un complemento.
Cómo se escribe
Se coloca dentro de una etiqueta script con el tipo application/ld+json, normalmente en la cabecera de la página (también vale en el cuerpo). Un ejemplo para un restaurante:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Restaurant",
"@id": "https://www.ejemplo.es/#restaurante",
"name": "Casa Lola",
"servesCuisine": "Cocina vasca",
"telephone": "+34 944 000 000",
"address": {
"@type": "PostalAddress",
"streetAddress": "Calle Ercilla 10",
"addressLocality": "Bilbao",
"postalCode": "48009",
"addressCountry": "ES"
},
"openingHoursSpecification": {
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"],
"opens": "13:00",
"closes": "16:00"
}
}
</script>| Clave | Qué indica | En el ejemplo |
|---|---|---|
| @context | Qué vocabulario se usa | https://schema.org |
| @type | Qué tipo de cosa se describe | Restaurant |
| @id | Un identificador único para poder referirse a esa cosa desde otro bloque | …/#restaurante |
| @graph | Agrupa varias descripciones en un mismo bloque | (no usado aquí) |
| Resto de claves | Propiedades del tipo, en inglés y sensibles a mayúsculas | name, telephone, address… |
- 1
Elegir el tipo
El más específico de Schema.org para la página.
- 2
Rellenar
Solo con datos que también se ven en la página.
- 3
Insertar
En un script application/ld+json de la plantilla.
- 4
Validar
Prueba de resultados enriquecidos y validador de Schema.org.
- 5
Vigilar
Informes de mejoras de Search Console.
La mayoría de gestores de contenidos y complementos SEO generan parte del marcado automáticamente; revisa qué ponen antes de añadir el tuyo.
Propiedades útiles para un negocio local
En el marcado de un negocio local, Google exige dos propiedades: el nombre (name) y la dirección (address), con tantos campos como puedas. Recomienda además el teléfono, la web (url), las coordenadas (geo, con al menos cinco decimales de latitud y longitud), el horario con openingHoursSpecification y, en restaurantes, el tipo de cocina y la carta. Fuera de lo que pide Google, es habitual añadir el logotipo y, con sameAs, los enlaces a tus perfiles oficiales en redes sociales, para que el buscador relacione todo con la misma entidad.
Las reseñas y valoraciones (review, aggregateRating) tienen reglas propias: Google no admite que un negocio marque reseñas sobre sí mismo en su propia web para obtener estrellas en los resultados. No las añadas si no estás seguro de cumplir las directrices.
Ejemplo práctico: varias entidades enlazadas
El restaurante del ejemplo quiere describir, en su página de la carta, el propio restaurante, su web y la ruta de navegación. Los datos son ficticios, solo para este ejemplo. En lugar de tres bloques sueltos, usa uno solo con @graph y tres nodos:
| Nodo | @type | Cómo se relaciona |
|---|---|---|
| 1 | Restaurant | Tiene @id «…/#restaurante» |
| 2 | WebSite | Su propiedad publisher apunta a «…/#restaurante» |
| 3 | BreadcrumbList | Inicio › Carta, con position 1 y 2 |
Gracias a los identificadores, el buscador entiende que la web, el negocio y las migas de pan forman parte de lo mismo, sin repetir todos los datos en cada nodo. Es la ventaja de «enlazar» datos que da nombre al formato.
JSON-LD, microdatos y RDFa
Los tres sirven para escribir el mismo vocabulario y, según Google, son igual de válidos si el marcado es correcto. La diferencia es práctica: los microdatos y RDFa se escriben como atributos dentro del HTML visible (itemprop, property…), así que cualquier cambio de diseño puede romperlos. JSON-LD vive aparte y se puede generar desde la base de datos de la web, lo que lo hace más robusto y fácil de mantener dentro del SEO on-page. Google también lee JSON-LD inyectado con JavaScript, aunque es preferible que esté en el HTML inicial.
Errores frecuentes
- Comas de más o comillas tipográficas (“ ”) en lugar de rectas: el bloque entero deja de ser válido.
- Describir datos que no aparecen en la página, algo contrario a las directrices de Google.
- Duplicar el mismo negocio con datos distintos en el tema y en un complemento.
- Escribir propiedades en español o con mayúsculas incorrectas.
- Pegar un ejemplo de internet sin cambiar los datos de prueba.
Validar cada cambio con la prueba de resultados enriquecidos y revisar los informes de Google Search Console evita la mayoría. Los resultados vistosos que se pueden conseguir, como estrellas o precios, se explican en la ficha de resultados enriquecidos.
Si tu restaurante o tu negocio va a funcionar como sociedad, en montar tu SL con nosotros te explicamos cómo la creamos online; después llevamos su contabilidad y sus impuestos.
Preguntas frecuentes sobre JSON-LD
¿Qué significa JSON-LD?
JavaScript Object Notation for Linked Data: un formato estándar del W3C para escribir datos enlazados en JSON. En SEO se usa para los datos estructurados.
¿Dónde se pone el JSON-LD en una página?
Dentro de una etiqueta script con el tipo application/ld+json, normalmente en la cabecera, aunque también es válido en el cuerpo de la página.
¿Por qué Google recomienda JSON-LD?
Porque es el formato más fácil de implementar y mantener: va separado del HTML visible y se puede generar automáticamente. Los microdatos y RDFa también son válidos.
¿Cómo compruebo si mi JSON-LD es correcto?
Con la prueba de resultados enriquecidos de Google y con el validador de Schema.org. Un solo error de sintaxis, como una coma de más, invalida todo el bloque.
Conceptos relacionados
- Datos estructurados: Los datos estructurados son información añadida al código de una página, en un formato estándar, que explica a los buscadores qué contiene: un negocio, un producto, una receta o unas preguntas frecuentes.
- Schema.org: Schema.org es el vocabulario común, lanzado en 2011 por Google, Microsoft y Yahoo, al que se sumó Yandex, que define los tipos y propiedades con que se describen negocios, productos o eventos en los datos estructurados.
- Rich snippets (resultados enriquecidos): Los rich snippets o resultados enriquecidos son resultados de Google que muestran información extra, como valoraciones, precio, disponibilidad o migas de pan, gracias a los datos estructurados de la página.
- Migas de pan web: Las migas de pan (breadcrumbs) son la ruta de enlaces que muestra dónde está una página dentro de la estructura de una web, por ejemplo Inicio › Servicios › Fontanería.
- Google Search Console: Google Search Console es la herramienta gratuita de Google que muestra al propietario de una web sus búsquedas, clics, páginas indexadas y problemas detectados. Antes se llamaba Google Webmaster Tools.
- SEO on-page: El SEO on-page es la optimización de cada página de tu web, su contenido, título, encabezados, enlaces internos e imágenes, para que responda a una búsqueda y Google la entienda.
Volver a la guía de publicidad digital para consultar otros términos.
Fuentes
- W3C: JSON-LD 1.1, recomendación
- Google Search Central: introducción a los datos estructurados
- Google Search Central: generar datos estructurados con JavaScript
Contenido informativo de carácter general: no es asesoramiento de marketing ni una recomendación de plataformas o proveedores. Las marcas citadas pertenecen a sus titulares y Autónomos Pymes no tiene relación con ellas; sus funciones, nombres y condiciones pueden cambiar, así que consulta siempre su documentación oficial.
Fecha de publicación: . Última actualización: .
Espacio disponible para patrocinador
¿Tu marca aquí?
Patrocina esta guía de publicidad digital y llega a autónomos y dueños de pymes que quieren anunciarse en internet, mejorar su SEO o medir sus campañas. No solo mostramos tu agencia o herramienta: también recibes sus contactos.
- ✓ Formularios de petición de información
- ✓ Llamadas telefónicas
- ✓ Mensajes de WhatsApp
Herramientas gratis
Calculadoras gratuitas

¿Quieres saber cómo se quedará tu sueldo neto?
Calcula gratis tu sueldo neto mensual y anual a partir del bruto (o al revés), con las retenciones de 2026.
Calcular mi sueldo neto
¿Quieres saber una orientación del valor de tu empresa?
Estima gratis cuánto vale tu pyme por EBITDA o por facturación.
Valorar mi empresa
¿Cuál es el EBITDA de tu empresa?
Calcula gratis el EBITDA y el margen EBITDA de tu empresa, con gráficos y comparación con el año anterior.
Calcular mi EBITDA
¿Te conviene más el renting o comprar el coche?
Compara gratis el coste real de cada opción, con el IVA que recuperas y el ahorro en IRPF o Sociedades si eres autónomo o empresa.
Comparar renting y compra
¿Creamos tu empresa?
Somos economistas: creamos tu empresa online y llevamos tu contabilidad, tus impuestos y tus trámites.
Contacto
Cuéntanos tu caso y te respondemos sin compromiso:
- Oficina
- Calle Isaac Peral, 42, 1º-3, 28015 Madrid
- Horario
- Lun. a Jue. 9:00 – 18:00 · Viernes 9:00 - 14:00 · Sábados y domingos cerrado
¿Quieres patrocinar la guía de publicidad digital?
Lo leen autónomos y pymes que necesitan entender Google Ads, el SEO, la analítica o las cookies antes de invertir en publicidad o de contratar a una agencia. Como patrocinador no solo mostramos tu marca: también puedes recibir los formularios de petición de información, las llamadas telefónicas y los mensajes de WhatsApp de quienes lo consultan. Escríbenos y te contamos las opciones, o consulta nuestro programa de publicidad y patrocinio.
¿Qué es Autónomos Pymes Business Partners?
Es nuestro programa de empresas colaboradoras: compañías de sectores útiles para autónomos y pymes, que no compiten con nuestros servicios de creación de empresas y asesoría. Solo si marcas la casilla opcional del formulario, Autónomos Pymes (responsable del tratamiento) les cederá tu nombre, teléfono y email para que te envíen información de sus productos/servicios y/o ofertas comerciales, también por medios electrónicos.
Sectores de las empresas colaboradoras:
- banca y financiación
- software de facturación
- control horario
- seguros
- tecnología
- protección de datos
- renting de vehículos
- oficinas y coworking
- marketing digital
- prevención de riesgos laborales
- formación
- suministros
Es voluntario: no marcar la casilla no afecta a tu solicitud. Puedes retirar el permiso cuando quieras escribiendo a info@autonomos-pymes.com. Más información en nuestra política de privacidad.