La forma más rápida de añadir marcado de esquema en 2026 es generar un bloque JSON-LD, pegarlo dentro de una etiqueta <script type="application/ld+json"> en el <head> de tu página, y luego validarlo con la Prueba de resultados enriquecidos de Google antes de implementarlo. No necesitas un plugin de WordPress ni tocar microdatos. Esta guía te ofrece el flujo de trabajo exacto de copiar y pegar para sitios estáticos, Next.js y Google Tag Manager.
La mayoría de los tutoriales sobre cómo añadir marcado de esquema se quedan en "instala Yoast" o te dan un muro de teoría de schema.org. Ninguno de los dos ayuda si tienes un sitio codificado a mano, una aplicación React o cualquier cosa que no sea WordPress. A continuación, el camino sin plugins: qué es JSON-LD, dónde va, cómo escribirlo para los tres tipos de página más comunes y el ciclo de validar y luego implementar que detecta errores antes que Google.
Qué son realmente el marcado Schema y JSON-LD#
El marcado Schema son datos estructurados que agregas a una página para que los motores de búsqueda entiendan lo que el contenido significa, no solo las palabras que contiene. Una página de receta es solo texto para un rastreador hasta que Schema le dice "esto es una Receta, el tiempo de preparación es 15 minutos, la calificación es 4.8".
JSON-LD (Notación de Objetos JavaScript para Datos Vinculados) es el formato que Google recomienda para ese marcado. Es un bloque de JSON dentro de una etiqueta script. Se encuentra en tu HTML pero no se renderiza visualmente, por lo que es muy limpio de trabajar.
Hay tres formas de escribir datos estructurados: JSON-LD, microdatos y RDFa. Los microdatos y RDFa envuelven tu HTML visible en atributos adicionales, lo que es frágil y difícil de mantener. JSON-LD vive en un bloque autocontenido, separado de tu marcado.
Usa JSON-LD. Google lo ha preferido explícitamente durante años, es el más fácil de agregar y editar, y puedes colocarlo en cualquier parte de la página sin reescribir tu HTML existente.
Por qué Schema sigue siendo importante en 2026#
Schema ahora hace dos trabajos. El trabajo original son los resultados enriquecidos: calificaciones con estrellas, acordeones de preguntas frecuentes, tarjetas de recetas, migas de pan en la SERP. Google retiró algunos de estos (los resultados enriquecidos de FAQ y HowTo se redujeron), pero la mayoría de los tipos de resultados enriquecidos siguen vigentes.
El trabajo más nuevo y más grande es alimentar la IA. AI Overviews, ChatGPT Search y Perplexity leen datos estructurados para construir respuestas y decidir qué citar. Un Schema limpio hace que tu contenido sea legible por máquinas para los sistemas que cada vez más se interponen entre tú y el clic. Esa es la verdadera razón para molestarse en 2026.
Cómo añadir Schema Markup: El flujo de trabajo sin plugins#
Aquí está el bucle de alto nivel, luego detallaremos cada paso. Todo el proceso lleva menos de diez minutos una vez que lo has hecho una vez.
- Elige el tipo de schema que coincida con la página.
- Genera JSON-LD válido (a mano o con un generador).
- Pégalo en el
<head>de la página dentro de una etiqueta script. - Valida con la Prueba de Resultados Enriquecidos y el Validador de Schema Markup.
- Despliega y confirma en Search Console.
Esto funciona para cualquier stack: un archivo HTML estático, un sitio Jekyll o Hugo, Next.js, Astro, PHP puro, o un sitio que solo controlas a través de Google Tag Manager. El marcado es idéntico. Solo el método de inyección cambia según el stack, lo cual cubrimos en los pasos siguientes.
Paso 1: Elige el tipo de schema correcto para tu página#
Haz coincidir el tipo con lo que realmente es la página. Elegir el tipo incorrecto es la razón más común por la que el marcado se ignora. Tipos comunes y cuándo usarlos:
| Tipo de página | Tipo schema.org | Qué puede obtener |
|---|---|---|
| Entrada de blog / artículo de noticias | Article, BlogPosting, NewsArticle | Resultado enriquecido de artículo, elegibilidad para Top Stories |
| Página de producto | Product + Offer | Precio, disponibilidad, estrellas de reseñas |
| Receta | Recipe | Tarjeta de receta, tiempo de cocción, valoraciones |
| Negocio local | LocalBusiness | Detalles del pack de mapas, horario, teléfono |
| Empresa / marca | Organization | Panel de conocimiento, logo, perfiles sociales |
| Contenido de preguntas y respuestas | FAQPage | Alimenta respuestas de IA (resultado enriquecido retirado) |
| Tutoriales paso a paso | HowTo | Alimenta respuestas de IA (resultado enriquecido retirado) |
| Cualquier página | BreadcrumbList | Ruta de navegación en SERP |
Una sola página puede llevar más de un tipo. Una entrada de blog suele incluir BlogPosting más BreadcrumbList más, si es relevante, FAQPage. Puedes poner cada uno en su propia etiqueta script o combinarlos en un array @graph.
Solo marca contenido que sea realmente visible en la página. Añadir schema de
Recipea una página sin receta, o estrellas de reseñas inventadas, es una violación de spam de datos estructurados y puede desencadenar una acción manual.
Paso 2: Genera el código JSON-LD#
Tienes dos opciones. Escríbelo a mano si conoces bien el tipo, o usa un generador para evitar errores de sintaxis. Para la mayoría de las personas, generar es más rápido y mucho menos propenso a errores.
Aquí tienes cómo se ve un bloque mínimo de Article para que sepas la forma a la que apuntas:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Cómo añadir Schema Markup (JSON-LD) en 2026",
"author": {
"@type": "Person",
"name": "Saqib Zahoor"
},
"datePublished": "2026-06-25",
"image": "https://example.com/cover.png",
"publisher": {
"@type": "Organization",
"name": "Molixa",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
}
}
</script>
Cada bloque necesita tres cosas: @context establecido en https://schema.org, un @type, y las propiedades requeridas para ese tipo. Si las pones mal, los validadores lo rechazarán.
Para evitar el trabajo manual y los errores de coma final, nuestro generador gratuito de schema markup construye JSON-LD válido para Article, Product, FAQ, LocalBusiness, Organization y más. Rellenas los campos, genera la etiqueta script, y la salida ya es sintácticamente correcta para que no pierdas una hora con un corchete mal colocado.
Paso 3: Pega el script en el head de tu página#
El bloque JSON-LD va dentro de una etiqueta <script type="application/ld+json">. Google lo lee tanto si está en el <head> como en el <body>, pero <head> es la convención limpia. Cómo lo inyectes depende de tu stack.
HTML estático, Jekyll, Hugo, PHP puro: pega la etiqueta script completa directamente en el head de tu plantilla o archivo de página. Hecho.
Next.js (App Router): renderiza el script en tu página o layout. El patrón fiable usa dangerouslySetInnerHTML para que React no escape el JSON:
export default function Page() {
const jsonLd = {
"@context": "https://schema.org",
"@type": "Article",
"headline": "Cómo añadir Schema Markup (JSON-LD) en 2026"
};
return (
<>
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
{/* contenido de la página */}
</>
);
}
WordPress sin plugin: si realmente no quieres un plugin, pega el script en el header.php del tema, o usa el campo "HTML personalizado" / código de cabecera del tema. (Un plugin es una conveniencia opcional, no un requisito.)
Google Tag Manager (sin acceso al código): GTM es la salida de emergencia cuando no puedes editar el código fuente. Crea una nueva etiqueta, elige "HTML personalizado", pega tu bloque completo <script type="application/ld+json">, y configura el disparador para las páginas específicas donde aplica el marcado. Dos precauciones con la ruta de GTM a continuación.
GTM inyecta schema del lado del cliente, después de que la página se carga mediante JavaScript. Google puede renderizarlo y leerlo, pero algunos otros rastreadores y bots de IA pueden no ejecutar tu etiqueta. Si el schema es crítico, prefiere el marcado renderizado en el servidor y trata GTM como un plan B para páginas que no puedes editar de otra manera.
La segunda precaución con GTM: limita el disparador estrictamente. Una etiqueta que se activa en "Todas las páginas" marcará el mismo schema de Article en tu página de inicio, tu página de contacto y tu 404. Usa disparadores de ruta de página para que cada plantilla solo reciba el schema que le corresponde.
Paso 4: Valida antes de desplegar#
Nunca publiques schema que no hayas probado. Dos herramientas, dos trabajos:
- Prueba de Resultados Enriquecidos (search.google.com/test/rich-results): te dice si Google puede leer tu marcado y si la página es elegible para un resultado enriquecido específico. Úsalo para cualquier cosa que quiera una función SERP.
- Validador de Schema Markup (validator.schema.org): una verificación pura de sintaxis y estructura contra el estándar schema.org. Úsalo para detectar JSON mal formado y valores de propiedad no válidos, independientemente de la elegibilidad para resultados enriquecidos.
Ejecuta ambas. La Prueba de Resultados Enriquecidos señala campos requeridos faltantes (un Product sin name, un Article sin headline). El Validador detecta problemas estructurales que el verificador de resultados enriquecidos ignora, como una propiedad adjunta al tipo incorrecto.
Pega tu URL en vivo (una vez en staging) o el código sin procesar. Corrige cada error. Las advertencias son opcionales pero generalmente vale la pena resolverlas, porque un campo "recomendado" hoy puede convertirse en un requisito más adelante. Si quieres previsualizar cómo podría aparecer la página marcada en la búsqueda junto con el schema, nuestra herramienta de vista previa de snippet SERP muestra el título y la descripción lado a lado con tus anchos de píxel.
Paso 5: Despliega y confirma en Search Console#
La validación demuestra que la sintaxis es correcta. No demuestra que Google lo haya rastreado. Después de desplegar:
- Solicita la indexación de la URL en Google Search Console (Inspección de URL > Solicitar indexación).
- Espera un recrawleo. Puede tardar desde horas hasta semanas dependiendo de tu presupuesto de rastreo.
- Revisa el informe de Mejoras relevante en Search Console (por ejemplo, "Productos" o "Migas de pan"). Muestra elementos válidos, advertencias y errores detectados en tus páginas en vivo a escala.
Search Console es la única fuente de verdad sobre lo que Google realmente analizó en producción. Una página puede pasar la Prueba de Resultados Enriquecidos de forma aislada y aún así arrojar errores en vivo si, por ejemplo, tu CMS elimina la etiqueta script o un CDN almacena en caché una versión antigua. Vigila el informe de Mejoras durante una semana después del lanzamiento.
Errores comunes de Schema Markup que debes evitar#
Estos son los errores que silenciosamente arruinan los resultados enriquecidos incluso cuando tu JSON-LD se ve bien.
- Marcar contenido que no está en la página. Reseñas con estrellas sin reseñas visibles, o esquema de FAQ sin FAQ visible, es una violación de las directrices. Los datos estructurados deben reflejar lo que un visitante ve.
- Comas finales y comillas sin escapar. JSON es estricto. Una coma final rompe todo el bloque. Esta es exactamente la clase de error que un generador elimina.
- Tipo incorrecto para la página.
Articleen una página de producto, oLocalBusinessen una entrada de blog, confunde al analizador y no obtiene nada. - Bloques duplicados o conflictivos. Dos scripts
Articlecon titulares diferentes en la misma página envían señales mixtas. Mantén un bloque autorizado por tipo, o unifícalos en un@graph. - Olvidar el
publishery laimageen los artículos. Estos son comúnmente requeridos para la elegibilidad y se omiten rutinariamente. - IDs auto-referenciales que no coinciden. Si usas
@idpara vincular entidades (Article a Organization a Person), los IDs deben coincidir entre bloques.
Si un resultado enriquecido no aparece después de una validación exitosa y un recrawl, la causa es casi siempre la elegibilidad, no la sintaxis. Vuelve a verificar la Prueba de Resultados Enriquecidos para ese tipo de resultado específico. Elegible no garantiza visualización; Google decide por consulta.
Cuando Necesitas Más de un Tipo de Esquema#
Las páginas reales rara vez son de un solo tipo. Un artículo de reseña de producto puede justificar Article para la publicación, Product más Review para el artículo y BreadcrumbList para la navegación. Tienes dos formas limpias de combinarlos.
El enfoque más simple son múltiples etiquetas script, una por tipo. Google las lee todas. Es fácil de mantener porque cada bloque es independiente y puedes agregar o eliminar uno sin tocar los demás.
El enfoque más elegante es un solo arreglo @graph que contiene todas las entidades en una etiqueta script, vinculándolas con referencias @id. Esto evita repetir datos compartidos (los detalles de tu Organización, por ejemplo) y es como la mayoría de las plataformas CMS generan esquemas internamente. Usa @graph cuando las entidades se refieran entre sí; usa etiquetas separadas cuando sean independientes.
Para decidir qué tipos de esquema siguen valiendo la pena dados los cambios recientes de Google en resultados enriquecidos, nuestro análisis de si el esquema FAQ sigue siendo útil en 2026 explica qué se retiró y qué importa ahora para la búsqueda con IA, y la guía completa para generar esquemas para resultados enriquecidos profundiza en la selección de tipos.
Cómo agregar marcado de esquema de forma rápida: un resumen#
Saber cómo agregar marcado de esquema se reduce a un bucle repetible, no a memorizar schema.org. Elige el tipo que coincida con la página, genera JSON-LD válido, pégalo en una etiqueta <script type="application/ld+json"> en el head, valida con la Prueba de resultados enriquecidos y el Validador de marcado de esquema, luego despliega y confirma en Search Console.
No se necesita ningún plugin para esto. Los sitios estáticos, Next.js y GTM usan el mismo JSON-LD; solo cambia el punto de inyección. Genera tu marcado con el generador de esquema, pásalo por ambos validadores y revisa el informe de Mejoras después del despliegue. Ese es todo el flujo de trabajo, y escala desde una página hasta un sitio completo.
Preguntas Frecuentes#
¿Necesito un plugin para agregar marcado de esquema? No. JSON-LD es solo un bloque de script que pegas en el encabezado de tu página, por lo que cualquier sitio puede usarlo sin un plugin. Plugins como Yoast o Rank Math son una conveniencia para usuarios de WordPress, pero los sitios estáticos, aplicaciones Next.js e incluso sitios que controlas solo a través de Google Tag Manager agregan el mismo JSON-LD manualmente.
¿Dónde exactamente va el script JSON-LD?
Dentro de una etiqueta <script type="application/ld+json">, idealmente en el <head> de la página. Google lo lee desde el <head> o el <body>, pero el head es la convención más limpia. En Next.js, renderiza el script con dangerouslySetInnerHTML para que React no escape el JSON.
¿Cómo valido el marcado de esquema? Usa dos herramientas. La Prueba de Resultados Enriquecidos (search.google.com/test/rich-results) verifica si Google puede leerlo y si la página es elegible para un resultado enriquecido. El Validador de Marcado de Esquema (validator.schema.org) verifica la sintaxis y estructura en bruto contra la especificación de schema.org. Ejecuta ambos, corrige todos los errores y luego despliega.
¿Puedo agregar marcado de esquema a través de Google Tag Manager? Sí. Crea una etiqueta HTML personalizada, pega tu bloque completo de script JSON-LD y establece un activador de ruta de página para que solo se active donde aplica el marcado. El inconveniente es que GTM inyecta el esquema del lado del cliente, por lo que algunos rastreadores que no son de Google pueden no ejecutarlo. Prefiere esquema renderizado en el servidor cuando sea crítico y usa GTM como respaldo para páginas que no puedas editar.
¿El marcado de esquema sigue ayudando al SEO en 2026? Sí, de dos maneras. Todavía impulsa muchos resultados enriquecidos (producto, receta, migas de pan y más), y cada vez más alimenta AI Overviews, ChatGPT Search y Perplexity, que leen datos estructurados para construir y citar respuestas. El esquema no aumenta directamente los rankings, pero hace que tu contenido sea legible por máquinas para los sistemas que deciden qué se muestra.
¿Por qué mi resultado enriquecido no se muestra después de agregar esquema válido? La validación solo prueba que tu sintaxis es correcta. Un resultado puede no aparecer porque la página no es elegible para ese tipo de resultado, porque Google no ha vuelto a rastrear la página aún, o porque el marcado describe contenido no visible en la página. Verifica el tipo de resultado específico en la Prueba de Resultados Enriquecidos, solicita indexación en Search Console y confirma que los datos coinciden con lo que ven los visitantes.
