Google Tag Manager (GTM) puede agregar schema a una página. Cree una etiqueta de tipo Custom HTML (HTML personalizado), pegue en ella un script JSON-LD, límítela a las páginas correctas, previsualícela, publique el contenedor y pruebe la URL en vivo. Google documenta este método en su guía sobre generar datos estructurados con JavaScript.
Este método tiene una condición. La etiqueta agrega el marcado después de que carga la página, por lo que un rastreador podría necesitar renderizarla antes de ver el marcado. Si puede modificar lo que el servidor entrega en la página, esa es la mejor ubicación para el schema.
Cuándo conviene Google Tag Manager para el schema
Use GTM cuando no tenga acceso a las plantillas ni al CMS, o cuando necesite administrar el marcado desde un solo lugar central. Ambas son razones prácticas, y ninguna convierte a GTM en una mala opción. Si su plataforma ya genera schema mediante un tema, un plugin de SEO o una aplicación, revise primero esa salida, porque un segundo bloque que describa la misma página puede crear duplicados.
El marcado que agregue debe describir contenido que los visitantes puedan ver en la página. Debe coincidir con el título, el autor, las fechas, los productos, los precios y la disponibilidad actuales de la página, y debe usar un tipo y unas propiedades válidos de Schema.org. Las directrices generales de datos estructurados de Google también indican que el marcado generado por script puede procesarse cuando está presente en el DOM renderizado, y que Google no garantiza un resultado enriquecido ni un cambio en el posicionamiento.
Si su sitio funciona en una plataforma con sus propias opciones de schema, las guías de cada plataforma explican lo que ya hace cada una. Hay recorridos separados para WordPress, Shopify, Wix, Squarespace, Webflow y HubSpot. Para ver el panorama más amplio de agregar marcado por cualquier vía, lea cómo agregar marcado schema.
Cómo maneja Google el JSON-LD agregado con JavaScript
Google indica que admite JSON-LD insertado con JavaScript, incluido el JSON-LD agregado mediante GTM, y que los datos estructurados presentes en el DOM durante el renderizado pueden procesarse (Google Search Central, «Generate structured data with JavaScript», generar datos estructurados con JavaScript). El navegador carga la página, GTM ejecuta su etiqueta, la etiqueta inserta el script, y un rastreador que renderiza la página puede leerlo.
Ese orden es el origen de la principal limitación. Renderizar JavaScript puede agregar una demora antes de que un rastreador vea el marcado. La misma página de Google señala que el marcado Product generado por script puede hacer que los rastreos de Shopping sean menos frecuentes y menos confiables, sobre todo en el caso del precio y el inventario. En una entrada de blog o en una página de empresa cuyos datos casi no cambian, la demora importa menos. En un producto cuyo precio o existencias cambian con frecuencia, importa más.
La guía de Google para la configuración en sí es breve. Instale GTM en el sitio, agregue una etiqueta Custom HTML, pegue un bloque de datos estructurados compatible, publique el contenedor y pruebe la implementación. También recomienda usar variables de GTM para recopilar los valores de la página, de modo que no tenga que copiar a mano los mismos datos en un segundo lugar.

Elija el tipo de schema y las propiedades
Antes de abrir GTM, decida qué es la página y qué tipo la describe. Una página de noticias o de blog normalmente usa Article, NewsArticle o BlogPosting, y una página con ruta de navegación también puede usar BreadcrumbList. El ejemplo completo usa BlogPosting. Si quiere los detalles de propiedades de un tipo, la guía de schema de artículo y la guía de schema de ruta de navegación explican cada campo.
Distinga dos tipos de requisito. Schema.org define el vocabulario, es decir, los tipos y las propiedades que puede usar. Después, Google enumera sus propios requisitos para cada función de búsqueda que todavía muestra. Una propiedad puede ser vocabulario válido sin que Google la exija, y un tipo puede ser válido sin que exista ninguna función de Google detrás de él.
La página de Google sobre datos estructurados de Article indica que no hay propiedades obligatorias de Article y recomienda agregar las que correspondan, entre ellas author, el nombre del autor, la URL del autor, headline, imágenes y fechas. Su página sobre ruta de navegación es más estricta, y la tabla siguiente muestra la diferencia.
Cree la etiqueta Custom HTML paso a paso
Trabaje en el espacio de trabajo de GTM del contenedor que está instalado en su sitio. Si no está seguro de que esté instalado, cargue la página en vivo, abra las herramientas para desarrolladores del navegador y busque el script de GTM en el HTML de la página antes de crear nada. Luego siga este orden.
- Confirme que el contenedor de GTM esté instalado en el sitio.
- En GTM, abra Tags (etiquetas) y seleccione New (nueva).
- Elija Custom HTML como tipo de etiqueta.
- Agregue un script JSON-LD para el tipo de página, envuelto en las etiquetas
<script type="application/ld+json">. - Cree variables para los valores que ya existen en la página.
- Agregue un activador de vista de página (page-view) limitado al patrón de URL o a la plantilla correctos.
- Guarde la etiqueta.
- Use la vista previa de GTM (Preview) y Tag Assistant para confirmar que la etiqueta se activa una sola vez.
- Publique el contenedor.
- Pruebe la URL en vivo con la Prueba de resultados enriquecidos (Rich Results Test) de Google y con la inspección de URL (URL Inspection) de Search Console.
La página de ayuda de Google Tag Manager sobre etiquetas personalizadas indica que el JavaScript de Custom HTML debe ir dentro de etiquetas script, y que las variables de GTM usan llaves dobles, como {{Page URL}}. El activador merece más atención, porque controla dónde aparece el marcado. Use un activador de vista de página con una condición sobre la URL, por ejemplo una ruta que coincida solo con sus entradas de blog, para que la etiqueta no describa páginas equivocadas.
Use variables sin romper el JSON
Las variables permiten que la etiqueta lea datos que ya existen en la página. La variable integrada de GTM Page URL (URL de la página) sirve para los valores url y mainEntityOfPage, y Page Title (título de la página) puede aportar un título sencillo. Para algo más estructurado, los tipos de variables definidos por el usuario de GTM incluyen una variable de capa de datos (Data Layer Variable) para datos estructurados de la página, una variable de elemento DOM (DOM Element Variable) para un valor visible en el HTML, y una variable de JavaScript personalizado (Custom JavaScript Variable) para un valor que deba calcularse.
Una variable de JavaScript personalizado que devuelve el título de la página se ve así:
function() {
return document.title;
}Para usarla, cree la variable en GTM, póngale un nombre claro, como «Titular de la página», y escriba {{Titular de la página}} donde corresponda el valor del titular en su script. Google recomienda recopilar la información de la página con variables en lugar de copiar los datos en GTM, porque así disminuye el riesgo de que la página visible y el JSON-LD se desfasen.
El escapado de caracteres es la única trampa técnica. Una comilla, un salto de línea o una barra invertida dentro de un título o una descripción pueden romper el JSON. Por eso, con valores tomados de la página, devuelva una cadena JSON ya terminada desde una variable de JavaScript personalizado, o léala de un objeto de capa de datos estructurado, en lugar de pegar texto sin procesar entre comillas.
Un script BlogPosting completo para adaptar
Este es un ejemplo ficticio para una página en example.com. Cada URL, nombre y fecha es un marcador de posición, así que reemplace cada uno por información que esté visible en su página real. El marcado usa el tipo BlogPosting de Schema.org, que define propiedades como headline, author, datePublished, dateModified, image, mainEntityOfPage y publisher.
Pegue el bloque completo en la etiqueta Custom HTML, incluidas las etiquetas script. Cambie @id y url por la dirección real de la página, y mantenga datePublished y dateModified en el formato mostrado, con el desfase horario (offset) de su zona horaria. El author aquí es una organización; si una persona con nombre escribió la página, describa a esa persona en su lugar.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"@id": "https://example.com/blog/adding-schema-with-gtm/#article",
"url": "https://example.com/blog/adding-schema-with-gtm/",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/blog/adding-schema-with-gtm/"
},
"headline": "Agregar schema con Google Tag Manager",
"description": "Una guía práctica para agregar datos estructurados JSON-LD mediante Google Tag Manager.",
"image": [
"https://example.com/images/schema-with-gtm-1200x675.jpg"
],
"datePublished": "2026-10-01T09:00:00-05:00",
"dateModified": "2026-10-15T11:30:00-05:00",
"author": {
"@type": "Organization",
"name": "Example Publishing",
"url": "https://example.com/about/"
},
"publisher": {
"@type": "Organization",
"name": "Example Publishing",
"url": "https://example.com/",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/images/example-publishing-logo.png"
}
},
"articleSection": "Platforms",
"inLanguage": "en-US"
}
</script>El ejemplo sirve para un artículo de blog y no promete cómo aparecerá la página en la búsqueda. Si prefiere empezar con un formulario en lugar de un bloque de código, el generador de schema de artículo crea un bloque del mismo tipo. Aun así, debe reemplazar los valores y probar la página publicada.
Para más patrones que copiar, vea los ejemplos de schema JSON-LD.
Agregue un BreadcrumbList en una segunda etiqueta
Una ruta de navegación es una entidad aparte, así que asígnele su propia etiqueta Custom HTML con su propio envoltorio script, y use el mismo activador. Mantener un bloque JSON-LD por etiqueta facilita previsualizar cada parte del marcado y desactivarla por separado. El bloque siguiente es el contenido de ese segundo script, mostrado sin el envoltorio para que siga siendo JSON válido.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"@id": "https://example.com/blog/adding-schema-with-gtm/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Blog",
"item": "https://example.com/blog/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Agregar schema con Google Tag Manager",
"item": "https://example.com/blog/adding-schema-with-gtm/"
}
]
}Para la función de ruta de navegación de Google, itemListElement es obligatorio, y cada ListItem necesita position y name. La propiedad item es obligatoria, salvo en el último elemento, donde Google puede usar la URL de la página actual. Necesita al menos dos elementos, y la ruta debe ser un recorrido normal que seguiría un visitante, y no simplemente una copia de la estructura de la URL.
Pruebe antes y después de publicar
Comience en la vista previa de GTM (Preview). Cargue la URL prevista, abra Tag Assistant y confirme que la etiqueta se activa una sola vez. Luego abra las herramientas para desarrolladores del navegador, busque el DOM renderizado y confirme que hay un bloque JSON-LD válido en la página, ni cero ni dos.
Después de publicar el contenedor, pase la URL en vivo por la Prueba de resultados enriquecidos de Google, y abra la inspección de URL en Search Console para ver la página renderizada. Google indica que, si la Prueba de resultados enriquecidos no admite un tipo de datos estructurados, debe inspeccionar el HTML renderizado en su lugar. El Schema Markup Validator comprueba el contenido frente al vocabulario, y el comprobador de Schema Nova lee el marcado de una página que pegue o de una URL que ingrese. La guía sobre cómo reemplazar la antigua herramienta de prueba de datos estructurados explica qué comprobación responde cada pregunta.
Tenga claro qué significa un resultado correcto. Google indica que la Prueba de resultados enriquecidos y la inspección de URL detectan la mayoría de los errores técnicos, pero no pueden garantizar que el resultado se muestre. Una prueba superada indica que la página probada contiene marcado que cumple las comprobaciones técnicas de la herramienta para esa función. No demuestra que Google vaya a mostrar un resultado enriquecido ni que los posicionamientos vayan a cambiar. Después de la publicación, revise el informe de resultados enriquecidos correspondiente en Search Console.

Corrija los fallos más comunes
La etiqueta se activa en páginas equivocadas, más de una vez, o no se activa. Vuelva a abrir el activador, compare su condición de URL con la ruta real de la página y use la vista previa para ver qué etiquetas se activan en cada carga. Una etiqueta que se activa dos veces suele significar que hay dos activadores asociados, o que una segunda etiqueta contiene el mismo script.
El marcado describe datos antiguos. Una etiqueta que mantiene a mano seguirá describiendo el título, el precio, el autor o la fecha del mes pasado hasta que alguien la edite. Tome los valores de la página mediante variables siempre que pueda, y revise la etiqueta cada vez que cambie la plantilla de la página.
La etiqueta nunca se ejecuta. Una configuración de consentimiento o una restricción de etiqueta en GTM puede impedir que se active. Revise cómo trata su herramienta de consentimiento las etiquetas Custom HTML, y lea el estado de activación de la etiqueta en la vista previa.
Dos sistemas publican el mismo elemento. Un CMS, un plugin de SEO y GTM pueden generar cada uno la misma entidad. Revise el HTML renderizado de la página en busca de bloques repetidos de Article u Organization, y conserve uno. Por último, recuerde que Schema.org puede admitir un tipo que Google no usa actualmente para un resultado enriquecido, así que un bloque válido no es una promesa de una visualización especial.
Haga que el marcado de GTM sea legible para Bing y la búsqueda con IA
Bing también lee JSON-LD, así que la misma etiqueta sirve para ambos, y Bing indica que el marcado debe reflejar con exactitud el contenido visible (Bing Webmaster Tools). Revise la página publicada en la herramienta de inspección de URL de Bing y en su Markup Validator. Yandex ofrece un Structured Data Validator para la misma tarea. Como GTM agrega el marcado después de que carga la página, confirme en cada herramienta que el marcado renderizado se detecta.
Para que la búsqueda de ChatGPT llegue a la página, permita OAI-SearchBot en robots.txt (resumen de rastreadores de OpenAI). Mantenga abierto también el rastreo de Bing, ya que Copilot con acceso web puede usar resultados de Bing (Microsoft Learn). Para Perplexity y DuckDuckGo, mantenga el contenido visible de la página claro y exacto. Consulte si los sistemas de IA usan el marcado schema para la comparación completa.
Cuándo es mejor el marcado renderizado por el servidor
GTM es un método de implementación, no un tipo mejor de schema. Si usted o un desarrollador pueden agregar el JSON-LD a la plantilla de la página, el marcado forma parte del HTML que envía el servidor, así que no espera a que se ejecute un script. Esa es la opción más sólida para el marcado que cambia con frecuencia, sobre todo los precios y la disponibilidad de los productos, y la nota de Google sobre los rastreos de Shopping, descrita antes, apunta en el mismo sentido.
Un patrón sensato para muchos equipos es empezar con GTM mientras no haya acceso a la plantilla, pasar el marcado a la plantilla cuando pueda editarse, y eliminar la etiqueta de GTM en ese momento para que la página no tenga dos copias. Los desarrolladores que trabajan en un sitio con Next.js o React pueden leer la guía sobre JSON-LD en Next.js y React.
Preguntas frecuentes
¿Puedo agregar schema de Product mediante GTM?
Puede hacerlo, pero es el caso que Google señala con más frecuencia. El marcado Product generado por script puede hacer que los rastreos de Shopping sean menos frecuentes y menos confiables, sobre todo en precio e inventario. Si los precios o las existencias cambian con frecuencia, coloque el marcado en la respuesta del servidor, y consulte la guía de marcado schema de producto para ver las propiedades.
¿Por qué la Prueba de resultados enriquecidos no detecta mi schema de GTM?
Empiece por lo básico. Confirme que la etiqueta se publicó, que se activa en esa URL exacta y que no la bloquea una configuración de consentimiento. Si la Prueba de resultados enriquecidos no admite el tipo, Google sugiere inspeccionar el HTML renderizado en la inspección de URL.
¿Sigue siendo útil el schema FAQPage para Google?
FAQPage sigue siendo un tipo válido de Schema.org, pero las actualizaciones de la documentación de Google indican que su resultado enriquecido de preguntas frecuentes ya no se muestra en la Búsqueda de Google a partir del 7 de mayo de 2026. No lo agregue con la esperanza de esa visualización. La guía de schema de preguntas frecuentes explica lo que el tipo todavía hace.
¿Un schema válido garantiza un resultado enriquecido?
No. Google indica que los datos estructurados hacen que una página sea elegible para una función, pero no garantizan que se muestre. Lo mismo ocurre con los fragmentos enriquecidos de Bing y con los fragmentos de Yandex, cada uno según su propia documentación.
¿El schema de GTM funciona para Bing y Yandex?
Ambos proveedores documentan la compatibilidad con Schema.org, y Bing y Yandex ofrecen cada uno su propio validador. Si un motor específico renderiza JavaScript antes de leer la página es algo que debe confirmar en la documentación y en las herramientas de ese proveedor, así que pruebe con Bing Webmaster Tools y con el validador de Yandex en lugar de suponerlo.
