Cuando hablamos de schema markup, en realidad estamos hablando de tres formatos posibles para añadir datos estructurados a una página web: Microdata, RDFa y JSON-LD. Los tres hacen lo mismo — comunicarle a los motores de búsqueda qué tipo de contenido tiene la página — pero de formas muy distintas. Google recomienda explícitamente JSON-LD sobre los otros dos. Entender por qué ayuda a implementarlo correctamente.
Los tres formatos de schema markup
| Formato | Dónde se coloca | Ventaja | Inconveniente |
|---|---|---|---|
| Microdata | Dentro del HTML, como atributos de las etiquetas | Semántica integrada con el contenido visible | Dificulta el mantenimiento, código mezclado |
| RDFa | Dentro del HTML, como atributos de las etiquetas | Compatible con estándares W3C más amplios | Sintaxis compleja, poco adoptado en la práctica |
| JSON-LD | Bloque <script> independiente en el <head> o <body> | Código separado del HTML, fácil de mantener | No está integrado directamente con el DOM visible |
Por qué Google recomienda JSON-LD
Google ha declarado oficialmente su preferencia por JSON-LD en su documentación técnica. Las razones prácticas son claras:
- •Separación de responsabilidades: el schema está en un bloque <script> independiente, sin mezclarse con el HTML de contenido. Esto facilita enormemente el mantenimiento y las actualizaciones.
- •Inyección dinámica: se puede añadir y modificar con JavaScript sin tocar el HTML existente, lo que lo hace compatible con aplicaciones React, Vue o Next.js.
- •Legibilidad: es mucho más fácil de leer, escribir y depurar que Microdata o RDFa, donde el schema está disperso por todo el HTML.
- •Portabilidad: el mismo bloque JSON-LD puede copiarse entre páginas con mínimas modificaciones.
Estructura básica de un JSON-LD
Todo JSON-LD de schema.org sigue la misma estructura básica: se envuelve en una etiqueta <script type="application/ld+json"> y dentro va un objeto JSON con al menos dos propiedades: @context (siempre "https://schema.org") y @type (el tipo de entidad: Article, Product, LocalBusiness, etc.).
- •@context: siempre "https://schema.org" — indica el vocabulario que se usa.
- •@type: el tipo de entidad que describe el schema (Article, Product, FAQPage, etc.).
- •Propiedades específicas del tipo: nombre, descripción, URL, imagen, precio, autor... dependen del @type elegido.
- •@id: opcional pero recomendado — URL única que identifica la entidad de forma inequívoca.
Tipos más utilizados y sus rich results
| @type | Rich result en Google | Dificultad de implementación |
|---|---|---|
| Article / BlogPosting | Imagen, autor y fecha en resultados AMP y Top Stories | Baja |
| Product | Estrellas, precio, disponibilidad en resultados de producto | Media |
| FAQPage | Preguntas expandibles directamente en el SERP | Baja |
| HowTo | Pasos numerados en el SERP (desktop y mobile) | Baja |
| LocalBusiness | Knowledge Panel con dirección, horarios y valoraciones | Media |
| Event | Fecha, lugar y precio en resultados de evento | Baja |
| Recipe | Imagen, tiempo de preparación, calorías en resultados de receta | Media |
| BreadcrumbList | Migas de pan en la URL mostrada en el SERP | Baja |
Errores más comunes al implementar JSON-LD
- •JSON inválido: una coma de más, una llave sin cerrar o comillas incorrectas invalidan todo el schema. Valida siempre con un linter JSON antes de publicar.
- •Propiedades requeridas ausentes: cada tipo tiene propiedades mínimas obligatorias. Sin ellas, Google no activa el rich result.
- •Contenido que no coincide con la página: el schema debe describir el contenido real de la página. Poner precios incorrectos o valoraciones falsas puede resultar en penalización manual.
- •Schema en páginas incorrectas: un schema Product en una página de blog o un schema Article en una ficha de producto confunde a Google.
- •Múltiples schemas del mismo tipo en conflicto: si tienes dos schemas Product con precios diferentes, Google elige uno y puede mostrar datos incorrectos.
Genera tu JSON-LD en segundos con IA
El Generador de Schema con IA de iRankly analiza el contenido de tu página o la descripción que le proporciones y genera automáticamente un JSON-LD válido y completo para el tipo de schema que necesitas. Sin errores de sintaxis, con todos los campos recomendados por Google.
Prueba la herramienta gratis
Analiza tus URLs con Generador de Schema con IA de iRankly. Sin registro, sin tarjeta.