Guía 3 · Serie de datos estructurados
Cómo implementar datos estructurados paso a paso con JSON-LD
JSON-LD es un formato práctico para implementar datos estructurados sin alterar el contenido HTML visible. Permite describir artículos, servicios, productos, cursos, organizaciones y otras entidades mediante vocabulario de Schema.org.
En esta guía aprenderás a identificar el tipo de contenido, construir el marcado, insertarlo en WordPress y comprobar que no contiene errores, duplicaciones ni información que contradiga la página.
Qué es JSON-LD y para qué sirve
JSON-LD significa JavaScript Object Notation for Linked Data. Es una forma de representar datos enlazados mediante un objeto JSON independiente del contenido visible.
A diferencia de los microdatos o RDFa, JSON-LD no obliga a incorporar atributos dentro de cada elemento HTML. El marcado se agrupa en un bloque separado que describe el contenido principal, sus propiedades y su relación con otras entidades.
Ventajas de JSON-LD
- No modifica el diseño visible.
- Se mantiene en un bloque independiente.
- Permite relacionar entidades mediante
@id. - Puede generarse dinámicamente desde un CMS.
- Facilita la revisión y validación técnica.
Qué información puede describir
- Artículos y guías.
- Organizaciones y sitios web.
- Servicios y productos.
- Cursos y eventos.
- Preguntas frecuentes.
- Imágenes y rutas de navegación.
Dónde se coloca el código JSON-LD
El código debe incluirse dentro de una etiqueta
<script> con el tipo
application/ld+json. Puede colocarse en el encabezado o en
el cuerpo del documento.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebPage",
"name": "Título visible de la página",
"url": "https://www.ejemplo.com/pagina.html"
}
</script>
Metodología para implementar JSON-LD
Paso 1: identificar la entidad principal
Antes de escribir el código, define qué representa realmente la URL. Esta decisión ayuda a evitar schemas innecesarios o tipos que no corresponden con el contenido.
Artículo o guía
Utiliza Article o BlogPosting para
contenidos editoriales e informativos.
Servicio
Utiliza Service y relaciónalo con la organización que
presta el servicio.
Producto
Utiliza Product cuando exista un producto real y agrega
Offer solo si la oferta está visible.
Curso
Utiliza Course para describir una formación y sus
contenidos educativos.
Preguntas frecuentes
Utiliza FAQPage cuando las preguntas y respuestas sean
visibles para el usuario.
Navegación
Utiliza BreadcrumbList para representar la ruta
jerárquica de la página.
Paso 2: seleccionar las propiedades necesarias
Cada tipo de schema dispone de propiedades diferentes. Comienza con las que describen la entidad de manera clara y agrega propiedades adicionales solamente cuando exista información real para completarlas.
- Nombre o título visible.
- Descripción coherente con la página.
- URL canónica.
- Imagen representativa y accesible.
- Autor o entidad responsable.
- Organización que publica el contenido.
- Idioma del contenido.
- Relaciones con otros nodos mediante
@id.
Paso 3: utilizar identificadores estables
Los identificadores @id permiten conectar los nodos de un
gráfico. Por ejemplo, un artículo puede referirse a la página web, la
imagen principal y la organización responsable sin repetir toda la
información.
Ejemplos de datos estructurados JSON-LD
Ejemplo de Article
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://www.ejemplo.com/guia.html#article",
"url": "https://www.ejemplo.com/guia.html",
"headline": "Título visible de la guía",
"description": "Descripción de la guía.",
"image": "https://www.ejemplo.com/imagen.jpg",
"inLanguage": "es-CL",
"author": {
"@type": "Organization",
"name": "Nombre de la organización",
"url": "https://www.ejemplo.com/"
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://www.ejemplo.com/guia.html"
}
}
</script>
Ejemplo de FAQPage
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "¿Los datos estructurados ayudan al SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Ayudan a los buscadores a comprender el contenido y sus entidades, pero no garantizan posiciones ni resultados enriquecidos."
}
}
]
}
</script>
Ejemplo de Service
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Service",
"name": "Implementación de datos estructurados",
"description": "Servicio de revisión e implementación de datos estructurados para sitios web.",
"url": "https://www.ejemplo.com/servicio.html",
"provider": {
"@type": "Organization",
"name": "Nombre de la organización",
"url": "https://www.ejemplo.com/"
},
"areaServed": {
"@type": "Country",
"name": "Chile"
}
}
</script>
Cómo insertar JSON-LD en WordPress
WordPress permite agregar datos estructurados mediante diferentes métodos. La opción correcta depende del número de páginas, el tipo de contenido y el nivel de acceso técnico.
| Método | Complejidad | Uso recomendado |
|---|---|---|
| Bloque HTML personalizado | Baja | Marcados específicos para una página concreta. |
| Plugin SEO | Baja | Generación del gráfico base del sitio, páginas y artículos. |
| Tema hijo o plugin propio | Media o alta | Generación dinámica a partir del contenido y campos del CMS. |
| Gestor de etiquetas | Media | Pruebas controladas o proyectos sin acceso directo al código. |
Complementa esta implementación con nuestras guías de SEO técnico con inteligencia artificial , WordPress para buscadores generativos y Discover y desarrollo de páginas web WordPress .
Cómo validar los datos estructurados
Después de insertar el código, debes comprobar su sintaxis, sus propiedades y su correspondencia con el contenido visible.
Resultados enriquecidos
Comprueba si el tipo implementado es compatible con alguna experiencia enriquecida de Google.
Schema.org Validator
Revisa la sintaxis y la estructura general de los tipos y propiedades utilizados.
Search Console
Permite revisar problemas detectados en páginas indexadas y tipos de resultados admitidos.
Qué debes comprobar
- Que el JSON sea sintácticamente válido.
- Que la URL sea la canónica de la página.
- Que la imagen exista y pueda rastrearse.
- Que el tipo de schema represente el contenido principal.
- Que las propiedades coincidan con la información visible.
- Que no existan nodos contradictorios o duplicados.
- Que los identificadores
@idsean consistentes.
JSON-LD, buscadores generativos e inteligencia artificial
Los datos estructurados ayudan a expresar entidades y relaciones de forma explícita. Esta claridad semántica puede facilitar la comprensión del contenido por buscadores tradicionales, motores de respuesta y sistemas basados en inteligencia artificial.
Sin embargo, implementar schema no sustituye el contenido útil, la experiencia demostrable, la autoridad temática, el enlazado interno ni la calidad técnica de la página.
Para ampliar este tema, revisa nuestras guías de búsqueda generativa , contenido para buscadores con IA , SEO centrado en las personas y WordPress para búsqueda generativa y Google Discover .
Errores frecuentes al implementar JSON-LD
Incluir precios, valoraciones, preguntas o servicios que el usuario no puede encontrar en la página.
Olvidar comas, llaves, comillas o dejar una coma después del último elemento.
Generar nodos contradictorios desde el plugin SEO, el tema y un bloque manual.
Marcar una guía como producto o utilizar reseñas cuando no existen valoraciones reales.
Incluir imágenes, páginas o identificadores que devuelven errores o redireccionan hacia destinos incorrectos.
Completar propiedades con información que no puede comprobarse solamente para evitar una advertencia.
Checklist antes de publicar JSON-LD
- El tipo elegido representa la función principal de la página.
- La URL coincide con la dirección canónica.
- La imagen principal existe y responde correctamente.
- La información del schema aparece en el contenido visible.
- Las preguntas frecuentes coinciden con las preguntas publicadas.
- No se inventaron precios, opiniones ni calificaciones.
- Los identificadores
@idson consistentes. - No existen schemas duplicados o contradictorios.
- El código fue comprobado con un validador.
- Los enlaces incluidos no devuelven errores 404.
Prompt para revisar un schema con inteligencia artificial
Actúa como especialista en SEO técnico y Schema.org. Analiza el contenido visible y el JSON-LD de la página. Comprueba: 1. Si el tipo de schema representa la entidad principal. 2. Si las propiedades coinciden con el contenido visible. 3. Si existen datos inventados, incompletos o contradictorios. 4. Si hay nodos duplicados. 5. Si los identificadores @id se relacionan correctamente. 6. Si las URLs e imágenes son absolutas. 7. Si el JSON contiene errores de sintaxis. No inventes precios, fechas, opiniones ni propiedades. Entrega primero los errores y después un código corregido.
Preguntas frecuentes sobre JSON-LD
¿Qué es JSON-LD?
Es un formato para representar datos estructurados mediante un bloque JSON independiente del contenido HTML visible.
¿Dónde se debe colocar el JSON-LD?
Puede colocarse en el encabezado o en el cuerpo del documento mediante una etiqueta script con el tipo application/ld+json.
¿JSON-LD modifica el diseño de la página?
No. El bloque entrega información estructurada a los sistemas que procesan la página, pero no genera elementos visuales para el usuario.
¿Puedo utilizar JSON-LD junto con Yoast SEO?
Sí, pero debes revisar el schema que Yoast ya genera para evitar nodos duplicados o contradictorios.
¿Los datos estructurados garantizan resultados enriquecidos?
No. Un marcado válido ayuda a interpretar el contenido, pero la presentación de resultados enriquecidos depende de los sistemas y políticas del buscador.
¿Cómo puedo validar un schema?
Puedes utilizar la prueba de resultados enriquecidos, el validador de Schema.org y los informes disponibles en Google Search Console.
¿Necesitas implementar JSON-LD sin errores?
En ChileYellow revisamos la arquitectura semántica del sitio, corregimos marcados duplicados y configuramos datos estructurados coherentes con el contenido visible.