Datos estructurados con Schema y JSON-LD: qué marcar y cómo probarlo

Los datos estructurados son un fragmento de código que describe el contenido de una página con un vocabulario estándar, Schema.org. En lugar de que Google tenga que deducir que «4,6» es una valoración media o que «29,90 €» es un precio, se lo dices explícitamente. A cambio, la página puede optar a resultados enriquecidos: estrellas, precio y disponibilidad, migas de pan, eventos, recetas… Además, ayudan a los buscadores y a los sistemas de IA a identificar con precisión quién eres, dónde estás y qué vendes.

El formato recomendado: JSON-LD

Hay tres formatos (JSON-LD, microdatos y RDFa), pero Google recomienda JSON-LD: un bloque <script> independiente del HTML visible.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Carpintería Hermanos Gil",
  "url": "https://carpinteriagil.es",
  "logo": "https://carpinteriagil.es/logo.png",
  "sameAs": [
    "https://www.instagram.com/carpinteriagil",
    "https://www.linkedin.com/company/carpinteriagil"
  ]
}
</script>

Puedes generar este código rellenando un formulario en el generador de Schema.

Los tipos más útiles

Cambios recientes de Google que conviene conocer

• FAQ: limitado en agosto de 2023 a webs oficiales y de salud reconocidas, y retirado para todos los sitios el 7 de mayo de 2026. Search Console eliminó después su informe. El marcado no perjudica y Google dice que puede seguir usándolo para entender el contenido, pero ya no da espacio extra en los resultados.
• HowTo: sus resultados enriquecidos dejaron de mostrarse en 2023.
• Simplificación de 2025: Google retiró el soporte de varios tipos poco usados (por ejemplo, Book Actions, Course Info, Claim Review, Estimated Salary o Vehicle Listing).

Antes de invertir tiempo en un tipo, consulta la galería de datos estructurados de Google Search Central para confirmar que sigue admitido.

Ejemplo: LocalBusiness

{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "name": "Clínica Dental Sonrisa",
  "image": "https://clinicasonrisa.mx/fachada.jpg",
  "telephone": "+52 55 1234 5678",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Av. Insurgentes Sur 1234",
    "addressLocality": "Ciudad de México",
    "postalCode": "03100",
    "addressCountry": "MX"
  },
  "openingHoursSpecification": [{
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"],
    "opens": "09:00",
    "closes": "19:00"
  }],
  "url": "https://clinicasonrisa.mx"
}

Usa el subtipo más específico que exista (Dentist, Restaurant, AutoRepair, LegalService…) en lugar del genérico LocalBusiness. Los datos deben coincidir con los de tu perfil de Google Business.

Ejemplo: Product

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Botas de montaña Senda GTX",
  "image": "https://tienda.ejemplo.es/img/senda-gtx.jpg",
  "sku": "SND-GTX-38",
  "brand": { "@type": "Brand", "name": "Senda" },
  "offers": {
    "@type": "Offer",
    "price": "129.90",
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock",
    "url": "https://tienda.ejemplo.es/botas-senda-gtx"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "87"
  }
}

Fíjate en que en JSON el precio se escribe con punto decimal (129.90), aunque en la página se muestre como 129,90 €. Las valoraciones deben ser reales y visibles en la página; Google no admite estrellas «autoasignadas» por la propia empresa en Organization o LocalBusiness.

Ejemplo: BreadcrumbList

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://ejemplo.es/" },
    { "@type": "ListItem", "position": 2, "name": "Guías", "item": "https://ejemplo.es/guias" },
    { "@type": "ListItem", "position": 3, "name": "Datos estructurados" }
  ]
}

Reglas básicas de Google

• El marcado debe describir contenido visible en la página. Marcar precios, reseñas o FAQ que el usuario no ve es una infracción.
• No marques contenido engañoso, irrelevante o desactualizado (precios antiguos, eventos pasados).
• Las infracciones pueden llevar a una acción manual que retira los resultados enriquecidos del sitio.

Cómo probar el marcado

1. Prueba de resultados enriquecidos de Google: indica qué resultados enriquecidos admite la página y los errores o advertencias.
2. Validador de Schema.org (validator.schema.org): comprueba la sintaxis de cualquier tipo, aunque Google no lo use.
3. Search Console → Mejoras: informes por tipo (productos, migas de pan…) con errores a escala de todo el sitio.
4. Revisa con el análisis SEO que la página tiene también title, description y encabezados correctos: los datos estructurados complementan el SEO básico, no lo sustituyen.

Errores frecuentes

• Copiar un JSON-LD de otra web sin cambiar el nombre, la URL o el logo.
• Comas sobrantes o comillas tipográficas (“ ”) que rompen el JSON.
• Usar coma decimal en price o ratingValue.
• Marcar reseñas que no aparecen en la página.
• Duplicar el mismo tipo con datos distintos (por ejemplo, el plugin SEO y el tema generan cada uno su Organization).
• Esperar resultados enriquecidos de FAQ o HowTo, que Google ya no muestra.

Lista de comprobación

• Organization (o LocalBusiness) en la portada con nombre, logo, URL y redes.
• Product con precio, moneda y disponibilidad en cada ficha.
• BreadcrumbList en páginas internas.
• Article en las entradas del blog, con fecha y autor.
• Todo el marcado coincide con el contenido visible.
• Prueba de resultados enriquecidos sin errores y Search Console revisado.

Para completar cómo se muestra tu página en buscadores y redes, consulta la guía de title y meta description.