Agregar datos estructurados sigue el mismo orden en todas las plataformas. Elija el tipo de schema.org que describe la página, reúna los datos que aparecen en ella, escríbalos como JSON-LD, colóquelos en su plantilla o en el campo de su plataforma, publique, y luego pruebe la URL publicada y revísela en Search Console.
Schema.org es el vocabulario compartido de tipos y propiedades que leen los buscadores, y JSON-LD es una forma de escribir esos datos como un pequeño bloque dentro de un elemento script. Google dice que recomienda JSON-LD porque es más fácil de mantener que Microdata o RDFa (directrices de Google sobre datos estructurados).
Antes de agregar nada, revise lo que ya genera su tema, su plugin o su aplicación. Muchas plataformas escriben algo de marcado por su cuenta, y una segunda descripción de la misma página es peor que una sola buena.
Los pasos en orden
- Elija la página y el tipo principal de schema que la describe.
- Lea la documentación de Google sobre la función que corresponde a ese tipo, si quiere cumplir los requisitos de la función de Google.
- Reúna los datos que aparecen en la página: nombre, autor, fechas, imágenes, precio, dirección.
- Escriba el JSON-LD, o genérelo, dentro de un elemento
script. - Coloque el bloque en la plantilla, en el campo de la plataforma, en el plugin, en la aplicación o en la salida generada por el servidor.
- Publique la página.
- Pruebe la URL publicada y luego revísela en Search Console y en Bing Webmaster Tools.
- Revise los informes y actualice el marcado cuando cambie la página.
Elija el tipo que corresponde a la página
Empiece por una página y pregúntese qué es. Una página editorial encaja con Article o BlogPosting. Una página sobre un solo producto encaja con Product. Un negocio físico encaja con LocalBusiness, idealmente con el subtipo más específico que corresponda. La página de inicio o la página sobre la empresa encaja con Organization. Otras opciones comunes son Event para una página de evento, Recipe para una receta y BreadcrumbList para las rutas de navegación.
Si no está seguro de qué tipo encaja, la guía de tipos de marcado schema explica los más comunes. Si el término en sí le resulta nuevo, qué es el marcado schema da una definición sencilla con un ejemplo práctico.
Una entidad es simplemente lo que se describe, como el artículo, el producto o el negocio. Elija un tipo que describa la página que el lector está viendo. Una página de categoría con cuarenta productos no es un solo Product, y un artículo sobre una receta no es un Recipe a menos que la página sea la receta.
Después, lea la documentación de Google sobre la función que corresponde a su tipo. Las propiedades requeridas por Google determinan la elegibilidad para un resultado enriquecido de Google, y schema.org define más propiedades de las que usa cualquier función de Google. Una propiedad puede ser vocabulario válido de schema.org y, aun así, no hacer nada para una función de Google determinada, y eso no es un error.
Reúna los datos que aparecen en la página
Abra la página en un navegador y anote lo que un lector puede ver: el título, el nombre del autor, la fecha de publicación, la imagen principal, el precio, la disponibilidad, la dirección o el horario de atención, según el tipo. Estos datos se convierten en los valores de su marcado.
Google dice que el marcado debe describir contenido visible en la página y que no debe marcar información que los lectores no pueden ver (directrices de Google sobre datos estructurados). Eso aplica a precios, calificaciones, reseñas, autores y fechas. Si la página muestra un precio de 12.00, el marcado dice 12.00. Si la página no tiene reseñas, el marcado no tiene reseñas.
Reunir los datos primero también le indica qué propiedades puede completar con valores verdaderos. Deje fuera una propiedad recomendada para la que no tenga un valor verdadero, en lugar de adivinar uno. Un campo opcional vacío no le cuesta nada, mientras que un valor inventado puede costarle la confiabilidad del marcado.
Revise también rápidamente las URL de las imágenes en esta etapa. Los rastreadores deben poder acceder a ellas, así que un enlace que está detrás de un inicio de sesión o que bloquea robots.txt no ayudará. Google pide imágenes que representen el artículo o el producto, y acepta varios recortes de la misma imagen.
Escriba el JSON-LD
Todo bloque tiene el mismo envoltorio: un elemento script con type="application/ld+json", un @context igual a https://schema.org y un @type. Todo lo demás son propiedades. Los dos ejemplos siguientes usan nombres ficticios en example.com. Reemplace cada valor con datos de su propia página y mantenga el marcado sincronizado con lo que ven los lectores.
El ejemplo de Article incluye las propiedades que Google recomienda para el marcado de Article. Google no enumera propiedades requeridas para esa función; recomienda headline, image, author, datePublished y dateModified, y publisher es opcional. Cambie el @id, la url, el headline, la description, las URL de las imágenes, el autor, el editor y ambas fechas. Agregue un desplazamiento horario a las fechas como se muestra, y actualice dateModified solo cuando realmente edite la página (datos estructurados de Article de Google).
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://example.com/blog/how-to-bake-sourdough#article",
"url": "https://example.com/blog/how-to-bake-sourdough",
"headline": "Cómo hornear pan de masa madre en casa",
"description": "Una guía práctica para hornear en casa un pan de masa madre sencillo.",
"image": [
"https://example.com/images/sourdough-1x1.jpg",
"https://example.com/images/sourdough-4x3.jpg",
"https://example.com/images/sourdough-16x9.jpg"
],
"author": {
"@type": "Organization",
"name": "Example Bakery",
"url": "https://example.com/about"
},
"publisher": {
"@type": "Organization",
"name": "Example Bakery",
"url": "https://example.com",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/images/example-bakery-logo.png"
}
},
"datePublished": "2026-05-04T09:00:00-05:00",
"dateModified": "2026-05-18T10:30:00-05:00",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/blog/how-to-bake-sourdough"
}
}
</script>El autor puede ser un Person o una Organization, según lo que la página muestre realmente como autor. Si prefiere completar un formulario en lugar de editar llaves, el generador de schema para artículos genera este bloque a partir de los mismos campos.
En el caso de una página de producto, el ejemplo de Product siguiente sigue la documentación de fragmentos de producto de Google. Un fragmento de Product necesita name y al menos uno de offers, review o aggregateRating. Cuando usa offers, price es obligatorio, y priceCurrency y availability se recomiendan (datos estructurados de Product de Google). Reemplace el nombre del producto, el SKU, la marca, el precio, la moneda, la disponibilidad y las URL con los suyos.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"@id": "https://example.com/products/example-sourdough-starter#product",
"url": "https://example.com/products/example-sourdough-starter",
"name": "Example Sourdough Starter",
"description": "Un cultivo inicial de panadería ficticio para hacer pan en casa.",
"image": [
"https://example.com/images/example-sourdough-starter-1x1.jpg",
"https://example.com/images/example-sourdough-starter-4x3.jpg",
"https://example.com/images/example-sourdough-starter-16x9.jpg"
],
"brand": {
"@type": "Brand",
"name": "Example Bakery"
},
"sku": "EXAMPLE-STARTER-001",
"offers": {
"@type": "Offer",
"url": "https://example.com/products/example-sourdough-starter",
"price": 12.00,
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>Este ejemplo no tiene calificaciones ni reseñas a propósito. Agregue review o aggregateRating solo cuando haya reseñas auténticas visibles en la página y las directrices de Google lo permitan. El generador de schema para productos cubre los mismos campos, y la guía de ejemplos de schema JSON-LD tiene bloques más completos para copiar en otros tipos.
Si está eligiendo entre JSON-LD, Microdata y RDFa, la comparación de formatos explica las diferencias. Bing Webmaster Tools dice que Bing admite los tres, así que la ruta de JSON-LD también sirve para Bing (Bing Webmaster Tools, cómo marcar su sitio con datos estructurados).
Revise lo que su sitio ya genera
Antes de colocar un bloque, averigüe si ya existe uno para la página. Abra la página publicada, vea el código HTML y busque application/ld+json. Un tema, un plugin SEO, una aplicación de la tienda o la propia plataforma puede describir ya el artículo, el producto, la organización o el sitio web.
Si ya existe un bloque para la misma entidad, edítelo o elija una sola fuente principal para ella. Dos bloques Product con precios distintos, o dos bloques Organization con nombres distintos, envían datos contradictorios sobre una misma página. Agregar un segundo bloque es apropiado cuando describe una entidad distinta y precisa que el primero no incluye.

Cuando sepa qué hay ya, decida dónde vivirá el nuevo marcado. Un tema o una plantilla encaja con tipos de página que se repiten, como entradas o productos, y un solo cambio llega a cada página de ese tipo; por eso un error ahí también llega a todas. Un plugin o una aplicación encaja con plataformas que tienen una integración mantenida. Un campo de código personalizado encaja con marcado específico de una página. El HTML estático sirve para un sitio programado a mano, aunque debe mantenerse al día a mano.
Coloque el bloque en su plataforma
Cada plataforma pone el código en un lugar distinto, y cada una tiene límites sobre lo que acepta su editor. Los nombres de los menús y las restricciones de los planes cambian, así que compárelos con lo que ve en su cuenta.
WordPress
Use un plugin SEO mantenido o una plantilla del tema como ruta principal, sobre todo para el marcado en todo el sitio. Para una sola página, agregue el JSON-LD a un bloque «Custom HTML» (HTML personalizado), publique y revise la página publicada. La documentación de WordPress indica que las etiquetas script pueden eliminarse para los usuarios sin la capacidad unfiltered_html, así que una cuenta de editor puede perder el elemento script al guardar (documentación de WordPress sobre el bloque Custom HTML). La guía de datos estructurados en WordPress profundiza en plugins, temas hijos y fragmentos de código.
Shopify
Empiece por el editor de temas, con una aplicación o con una integración del tema. Si edita el código directamente, vaya a «Online Store» (tienda en línea), luego a «Themes» (temas) y después a «Edit code» (editar código), y duplique primero el tema para tener una copia de respaldo. Agregue el marcado a la plantilla Liquid correspondiente y anote el cambio. Shopify dice que las actualizaciones del tema pueden eliminar el código personalizado, así que pruebe la página de nuevo después de cada actualización (Shopify: edición del código del tema). Las aplicaciones y las secciones de «Custom Liquid» (Liquid personalizado) son otra ruta (Shopify: aplicaciones y Custom Liquid).
Wix
Abra la configuración de SEO de la página, elija «Advanced SEO» (SEO avanzado), abra «Structured Data Markup» (marcado de datos estructurados) y seleccione «Add New Markup» (agregar marcado nuevo). Pegue el JSON-LD en el campo, póngale un nombre y aplíquelo. Wix también agrega marcado predefinido de forma automática a algunas páginas de producto y de blog, así que revise si ya hay un bloque antes de agregar otro (Wix: configuración del panel de SEO).
Squarespace
Squarespace dice que genera datos estructurados de forma automática para contenido compatible, como entradas de blog, eventos, negocios locales, organizaciones, productos y sitios web. Trate ese marcado generado como su punto de partida y evite un segundo bloque para la misma entidad, a menos que el marcado personalizado describa algo distinto y preciso (Squarespace: cómo optimiza su sitio para los resultados de búsqueda). Para cualquier bloque manual, siga la documentación vigente de Squarespace sobre inyección de código para su cuenta y su plan.
Webflow
Use «Site settings» (configuración del sitio) y luego «Custom code» (código personalizado) para el marcado que debe ir en todas las páginas, o «Page settings» (configuración de la página) y luego «Custom code» para una sola página. Las etiquetas script pueden ir en el head o antes de la etiqueta de cierre de body. Guarde y publique antes de probar, porque la página publicada es la que se prueba. Webflow describe el código personalizado como un cambio avanzado y dice que no garantiza su compatibilidad ni resuelve los problemas que cause (Webflow: código personalizado en las etiquetas head y body).
Sitios hechos a mano y Next.js
En un sitio programado a mano, coloque el elemento script completo en el head o en el body de la página, y use la URL canónica real de la página y los datos visibles. Después de publicar, pruebe la dirección publicada y no un archivo local.
En una aplicación de Next.js, muestre el JSON-LD en layout.js o en page.js. La documentación de Next.js indica que los valores serializados deben sanitizarse, porque un texto no confiable dentro de un elemento script puede romper ese elemento (guía de Next.js sobre JSON-LD). Reemplazar el signo menor que por su escape Unicode es el enfoque documentado.
export default function Page() {
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: 'Cómo hornear pan de masa madre en casa',
}
return (
<script
type="application/ld+json"
dangerouslySetInnerHTML={{
__html: JSON.stringify(jsonLd).replace(/</g, '\\u003c'),
}}
/>
)
}Complete el objeto con los datos de su página y agregue las propiedades restantes de su tipo, como en el ejemplo de Article anterior.

Tag Manager y el marcado agregado con JavaScript
Cuando no pueda acceder a las plantillas, Google Tag Manager es una opción. Cree una etiqueta «Custom HTML» que contenga el JSON-LD, publique el contenedor y pruebe la URL publicada. Cuando sea posible, use variables de Tag Manager que lean los datos de la página en lugar de escribirlos de nuevo, para que el marcado siga a la página cuando cambie. La configuración de consentimiento y el momento en que se activan las etiquetas pueden afectar si aparece el bloque, así que pruebe teniéndolo en cuenta.
Google dice que puede procesar JSON-LD presente en el DOM renderizado, lo que significa que el marcado agregado con JavaScript puede leerse (Google: generar datos estructurados con JavaScript). El DOM renderizado es la estructura de la página disponible después de que un navegador o un rastreador ha ejecutado sus scripts.
Para datos que cambian con rapidez, la salida renderizada en el servidor es la opción más segura. Renderizado en el servidor significa que el HTML se genera antes de enviarlo al navegador. Google advierte que el marcado de Product generado con JavaScript puede hacer que los rastreos de Shopping sean menos frecuentes y menos confiables en precios y disponibilidad que cambian a menudo (datos estructurados de Product de Google).
Pruebe la página publicada
Publique primero y después pruebe la URL publicada, porque una prueba de un borrador o de un fragmento pegado no demuestra que la página publicada tenga el bloque. Tres herramientas de Google responden tres preguntas distintas, y una herramienta de Bing cubre Bing.
Use la Prueba de resultados enriquecidos (Rich Results Test) de Google para revisar la página frente a los requisitos de las funciones de Google que admite. Use el Schema Markup Validator cuando quiera una validación general de schema.org más allá de las funciones de Google, ya que no aplica reglas de resultados enriquecidos específicas de Google. Para una revisión rápida de una URL o de código pegado, el comprobador de schema de Schema Nova lee el marcado, y el validador de schema lo compara con el vocabulario.
Después use la «URL Inspection» (inspección de URL) de Search Console para ver cómo Google indexó la página, qué mejoras detectó y cualquier error o advertencia (Google: supervisar datos estructurados con Search Console).
Bing tiene su propia ruta. Bing Webmaster Tools dice que Bing admite JSON-LD, Microdata y RDFa, y su «URL Inspection» tiene una tarjeta «Markup» (marcado) que muestra el marcado que Bing leyó de la página. Bing también dice que no garantiza que el marcado se muestre (Bing Webmaster Tools, inspección de URL).
Una prueba aprobada indica que el marcado se analiza correctamente y cumple las comprobaciones que aplica la herramienta. No indica que vaya a aparecer un resultado enriquecido. Google dice que no garantiza un resultado enriquecido aunque el marcado pase la Prueba de resultados enriquecidos, porque el contenido, la calidad, la relevancia y las reglas de cada función también importan.
Mantenga el marcado actualizado
El marcado se vuelve obsoleto cuando la página cambia y el bloque no. Los precios, la disponibilidad, los autores, las fechas y los datos del negocio son los casos más comunes. Después de editar una página o una plantilla, pruebe la URL publicada otra vez.
En los informes de mejoras de Search Console aparecen los errores y advertencias de marcado de los tipos sobre los que Google informa. Corrija la plantilla o el campo al que apuntan y después solicite que Google vuelva a revisar la URL. El nuevo rastreo y la reindexación pueden tardar, y conviene actualizar el mapa del sitio (sitemap) cuando agregue o cambie páginas.
Si su página no muestra la apariencia que esperaba, revise los puntos en orden. Confirme que la página se puede indexar, ya que una etiqueta noindex, un bloqueo en robots.txt o un muro de inicio de sesión impiden que la página se utilice. Confirme que el marcado está en la página publicada, que coincide con el contenido visible y que cumple las propiedades requeridas por la función de Google. Después confirme que la función todavía existe, porque Google retira algunas.
Errores que impiden que el marcado funcione
La causa más común de que el marcado falle es marcar algo que los lectores no pueden ver, o usar un precio, una calificación, un autor o una fecha que no coincide con la página visible. Agregar reseñas falsas o interesadas pertenece al mismo grupo.
Las decisiones de tipo y de propiedades causan el siguiente grupo de problemas: un tipo que no describe la página, un tipo demasiado general cuando corresponde uno más específico, o propiedades requeridas que faltan para la función de Google que usted quiere. El problema de las entidades duplicadas surge al usar un tema, un plugin, una aplicación y código personalizado juntos. Los precios desactualizados, las URL de imágenes inaccesibles y las páginas bloqueadas completan la lista.
La sintaxis válida por sí sola no produce un resultado enriquecido. Los datos estructurados pueden ser sintácticamente válidos y aun así no ser elegibles por el contenido, la calidad, la relevancia o las reglas propias de cada función. Si quiere saber más sobre lo que el marcado puede y no puede hacer por la búsqueda, si el marcado schema ayuda al SEO lo explica, y marcado schema frente a datos estructurados explica cómo se relacionan los dos términos.
Lo que el marcado puede y no puede hacer
El marcado ayuda a los buscadores a entender de qué trata una página, y puede hacer que una página sea elegible para una apariencia más rica en la búsqueda. Escriba un marcado preciso para la página y trate cualquier visualización como una posibilidad; si los sistemas de IA usan el marcado schema compara lo que dice cada sistema. No garantiza posiciones, tráfico, citas en la IA ni un resultado enriquecido.
La compatibilidad con las funciones también cambia. Google dejó de mostrar resultados enriquecidos de preguntas frecuentes (FAQ) en mayo de 2026 y eliminó la documentación de esa función en junio de 2026, aunque FAQPage sigue siendo un tipo válido de schema.org. El anuncio de Google Search Central de agosto de 2023 dijo que los resultados enriquecidos de HowTo se estaban retirando (blog de Google Search Central, cambios en los resultados enriquecidos de HowTo y FAQ).
La publicación de Google de octubre de 2024 indicó que el cuadro de búsqueda de enlaces de sitio se eliminaría a partir del 21 de noviembre de 2024 (blog de Google Search Central, despedida del cuadro de búsqueda de enlaces de sitio). Elija los tipos por lo que describen y trate una visualización de Google como un beneficio adicional.
Preguntas frecuentes
¿Cuál es la forma más fácil de agregar datos estructurados?
Use la ruta que ya admite su plataforma: un plugin SEO en WordPress, el editor de temas o una aplicación en Shopify, el campo Structured Data Markup en Wix, o el marcado generado en Squarespace. Genere el JSON-LD con un formulario, péguelo donde lo permita la plataforma y pruebe la URL publicada.
¿Puedo agregar datos estructurados sin un plugin?
Sí, siempre que pueda colocar un elemento script. En WordPress eso significa un bloque Custom HTML para una sola página, siempre que su cuenta pueda conservar las etiquetas script. En Wix, Webflow y los sitios hechos a mano significa usar el campo de código personalizado o el campo de datos estructurados. Revise antes si ya existe marcado.
¿Dónde va el JSON-LD en el HTML?
Dentro de un elemento script con type="application/ld+json", en el head o en el body de la página. La documentación de Webflow indica que cualquiera de las dos posiciones funciona, y Google lee el JSON-LD en cualquier lugar donde aparezca en la página renderizada. Elija un lugar y mantenga un solo bloque por entidad.
¿Puede Google leer el marcado schema agregado con JavaScript?
Google dice que puede procesar JSON-LD presente en el DOM renderizado, así que el marcado agregado por Tag Manager o por scripts de la página puede leerse. Para precios y disponibilidad que cambian con frecuencia, Google recomienda el marcado de Product renderizado en el servidor, porque el marcado generado con JavaScript puede hacer que los rastreos de Shopping sean menos confiables.
¿El marcado schema válido garantiza un resultado enriquecido?
No. Google dice que no garantiza un resultado enriquecido aunque el marcado pase la Prueba de resultados enriquecidos. La elegibilidad depende del contenido, la calidad, la relevancia y las reglas de la función específica, y algunas funciones se han retirado, así que consulte la documentación actual de Google para la suya.
¿Cuál es la diferencia entre la Prueba de resultados enriquecidos y el Schema Markup Validator?
La Prueba de resultados enriquecidos revisa una página frente a los requisitos de las funciones de búsqueda de Google que admite. El Schema Markup Validator revisa el vocabulario de schema.org en general y no aplica reglas de resultados enriquecidos específicas de Google. Use la primera para las funciones de Google y el segundo para todo lo demás.
