Schema.org sin morir en el intento: guía práctica

Schema.org es un vocabulario compartido —un diccionario de tipos como Article, Product o LocalBusiness— que sirve para declarar de forma explícita qué es cada cosa de tu página, en vez de dejar que un buscador lo deduzca del HTML. JSON-LD es la forma recomendada de escribirlo: un bloque de datos independiente que no toca nada de lo que ve el usuario. Puedes crear ese bloque con el generador de datos estructurados de Docuboxer, rellenando un formulario y copiando el resultado. Antes de empezar, la advertencia que ahorra decepciones: el marcado no te concede un resultado enriquecido, te concede elegibilidad.

Por qué JSON-LD y no microdatos

Hay tres sintaxis válidas para expresar Schema.org: microdatos y RDFa, que se incrustan como atributos dentro de tus etiquetas HTML, y JSON-LD, que va en un bloque <script type="application/ld+json"> aparte. Las tres se entienden igual de bien, pero solo una sobrevive a un rediseño.

Los microdatos obligan a que la estructura de datos y la estructura visual sean la misma: si alguien mueve un div o cambia una plantilla, el marcado se parte sin que nadie se entere. Con JSON-LD el bloque está aislado, se puede generar desde el servidor con los mismos datos que alimentan la página y se revisa de un vistazo. Por eso es la recomendación por defecto desde hace años, y por eso es lo único que genera la herramienta.

Lo que el marcado hace y lo que no

Merece la pena decirlo sin adornos porque casi toda la frustración con Schema.org nace de aquí. Los datos estructurados no son un factor de ranking. No suben posiciones por sí mismos y no compensan un contenido pobre. Lo que hacen es dos cosas concretas:

• Te vuelven elegible para funciones de búsqueda específicas —estrellas, precio, disponibilidad, migas de pan, ficha de negocio— que Google muestra o no según su criterio, la consulta y el dispositivo.
• Describen la página en un formato legible por máquinas, lo que importa cada vez más para buscadores, agregadores y sistemas de respuesta automática que necesitan saber qué es un precio y qué es una fecha sin adivinarlo.

La consecuencia práctica: puedes tener un marcado impecable y no ver ningún cambio visual en la SERP. No significa que esté mal; significa que la elegibilidad no es una garantía. Y también al revés — Google puede reescribir tu título y descripción en el resultado aunque el marcado sea perfecto, porque eso lo decide por otras vías.

Los tipos que compensan hoy

El vocabulario de Schema.org tiene cientos de tipos. Marcar por marcar no sirve de nada: solo unos pocos tienen un uso real y documentado. Estos son los que genera la herramienta y qué esperar de cada uno.

Article

Para posts, noticias y guías. Declara titular, autor, fechas de publicación y modificación e imagen principal. No produce un resultado enriquecido llamativo en la búsqueda web normal, pero es la base para aparecer en formatos como Noticias destacadas o Discover, y es la forma estándar de decir quién firma y cuándo se actualizó — señales de autoría que un buscador no debería tener que inferir.

FAQPage

Marca pares de pregunta y respuesta. Aquí toca ser honesto: desde agosto de 2023 el resultado enriquecido de FAQ quedó restringido a un grupo muy pequeño de sitios institucionales y sanitarios. Si tienes un blog o una tienda, no vas a ver el desplegable. Sigue siendo un marcado correcto y útil como descripción estructurada de la página, pero añadirlo esperando el resultado visual es prepararse para una decepción.

Product

El de mayor retorno visible, sin discusión. Precio, moneda, disponibilidad y valoración agregada pueden aparecer directamente en el resultado. Dos condiciones no negociables: los datos deben coincidir con lo que ve el usuario en la página, y las valoraciones deben ser reales y visibles. Inventar estrellas es la vía rápida a una acción manual.

LocalBusiness

Nombre, dirección, teléfono, horario y coordenadas de un negocio físico. Refuerza la identidad del negocio y su coherencia con el resto de menciones en la web. Un detalle que se pasa por alto: los datos del marcado deben coincidir exactamente con la ficha de Google Business Profile y con lo que aparece en el pie de tu web. Las incoherencias de nombre o dirección hacen más daño que la ausencia de marcado.

HowTo

Instrucciones paso a paso. Google retiró este resultado enriquecido en 2023, así que hoy no produce ningún formato visual en la búsqueda. Lo mantenemos en la herramienta porque el vocabulario sigue siendo válido y otros consumidores lo usan, pero si tu único objetivo es la SERP de Google, este es el tipo que puedes saltarte sin perder nada.

Cómo añadirlo sin romper nada

Un bloque JSON-LD es texto plano dentro de una etiqueta script. Va en el <head> o en el <body>, da igual, y no afecta al renderizado:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "El titular exacto del artículo",
  "datePublished": "2026-08-15",
  "dateModified": "2026-08-15",
  "author": { "@type": "Person", "name": "Nombre real del autor" },
  "image": "https://ejemplo.com/imagen-del-articulo.jpg"
}
</script>

Cuatro reglas que evitan el 90% de los problemas:

• Un bloque por entidad. Es más limpio tener tres scripts (Article, BreadcrumbList, Organization) que uno enorme con todo mezclado, y depurarlo es infinitamente más fácil.
• Nunca marques lo que no está en la página. Precios, valoraciones o preguntas invisibles para el usuario son spam de datos estructurados, con sanción documentada.
• Fechas en formato ISO 8601 (2026-08-15), URLs absolutas y con el mismo host canónico que usas en el resto del sitio. Si tu canónica lleva www, el marcado también.
• Genéralo desde los datos, no a mano. Un JSON-LD escrito a mano se queda desactualizado en cuanto cambia el precio o la fecha. Si tu CMS puede rellenarlo, que lo rellene.

Y una comprobación previa que se olvida siempre: el marcado no vale de nada si el buscador no puede rastrear la página. Antes de pelearte con el JSON-LD, verifica que tu archivo robots.txt no está bloqueando la ruta y que la URL está en tu sitemap XML.

Cómo validar

Usa los dos validadores, porque responden preguntas distintas. La Prueba de resultados enriquecidos de Google te dice si tu página es elegible para alguna función de búsqueda concreta; es la que importa si buscas visibilidad. El Schema Markup Validator de schema.org valida sintaxis y vocabulario aunque Google no use ese tipo, y es el que necesitas si marcas algo fuera del catálogo de Google.

Después de publicar, el informe de mejoras de Search Console es la fuente real: muestra los errores y avisos en las páginas ya rastreadas, no en un fragmento pegado. Los avisos (propiedades recomendadas ausentes) no impiden la elegibilidad; los errores sí.

Errores comunes

• Marcado en una plantilla que se repite en todas las páginas con los mismos valores. Un Product idéntico en 200 fichas distintas es una señal de descuido.
• Copiar un ejemplo y dejar los datos del ejemplo. Suena absurdo hasta que lo encuentras en producción.
• Confundir el marcado con las metaetiquetas. Son capas distintas: el JSON-LD describe la entidad; el título, la descripción y las Open Graph controlan cómo se presenta el enlace. Necesitas ambas cosas.
• Marcar tipos sin uso real para "cubrir más". No hay premio por cantidad de tipos, y sí ruido que revisar cada vez que algo falla.

Preguntas frecuentes

Herramientas relacionadas

• Generador de datos estructurados — JSON-LD para Article, FAQPage, Product, LocalBusiness y HowTo.
• Generador de meta etiquetas — Title, description y Open Graph para el mismo enlace.
• Previsualizador de SERP — Comprueba cómo se corta tu resultado antes de publicarlo.
• Generador de sitemap XML — Para que la página que marcas sea descubrible.

También te puede interesar: herramientas SEO gratuitas que funcionan sin registro y qué es un slug de URL y cómo escribirlo bien.