Los datos estructurados son la idea general: información organizada para que el software pueda leerla de forma coherente. El marcado schema consiste en datos estructurados escritos con el vocabulario de schema.org, y JSON-LD, Microdata y RDFa son los formatos que usa para escribirlo. Así que, cuando alguien le pide «agregar schema», normalmente se refiere a datos estructurados de schema.org, casi siempre escritos en JSON-LD.
Antes de agregar, editar o probar cualquier cosa, nombre la capa en la que está trabajando. Decida qué vocabulario describe la página, en qué formato lo escribirá y qué sistema quiere que lo lea. Después, revise lo que la página ya genera, agregue o edite una sola entidad y pruebe el resultado.
El marcado válido puede hacer que una página sea elegible para funciones que ofrece un motor de búsqueda. No garantiza un resultado enriquecido, una posición en los resultados, tráfico ni una cita en un sistema de IA.
Tres capas: vocabulario, formato y consumidor
Google explica en su introducción a los datos estructurados que los datos estructurados son un formato estandarizado para proporcionar información sobre una página y clasificar su contenido, y que la mayoría de los datos estructurados de Google Search usa schema.org. Por eso, en el lenguaje cotidiano del SEO, «datos estructurados» y «marcado schema» suelen referirse al mismo código. Técnicamente, uno es la categoría y el otro es un miembro de ella.
Conviene pensar el trabajo en tres capas. El vocabulario define los significados: Article, Product, Organization, Event y las propiedades que los describen, como name, author, price y startDate. El formato define cómo se escriben esos significados: JSON-LD, Microdata, RDFa o las etiquetas meta de HTML sencillas. El consumidor es el sistema que lee el resultado, como Google Search, Bing o una red social, y decide qué reconoce y qué muestra.
Cada capa responde a una pregunta distinta. Si pregunta «¿de qué tipo es esta página?», está eligiendo un tipo del vocabulario. Si pregunta «¿dónde va el código?», está eligiendo un formato. Si pregunta «¿esto se mostrará de alguna forma?», está preguntando por un consumidor, y la respuesta está en la documentación de ese consumidor, no en el vocabulario ni en el formato.

Un ejemplo pequeño hace concretas las capas. Tome un script JSON-LD con "@type": "Article" y un author de tipo Organization. Article y Organization vienen de schema.org. JSON-LD es la sintaxis. El script completo es marcado schema, y como el marcado schema es una clase de datos estructurados, también es datos estructurados. Schema.org en sí no es JSON-LD: la página de introducción de schema.org lo describe como un vocabulario que se puede usar con Microdata, RDFa o JSON-LD, y la especificación del W3C describe JSON-LD como una serialización basada en JSON para datos enlazados.
Si quiere la versión básica de esta definición, con más ejemplos, lea qué es el marcado schema y cómo funciona.
Lo que aporta schema.org
Schema.org es un vocabulario compartido de tipos y propiedades para describir cosas y sus relaciones en la web. Un tipo indica qué es algo, y las propiedades lo describen. El modelo de datos de schema.org permite que una cosa apunte a otra, de modo que un artículo pueda nombrar a su autor, y que el autor sea una organización con su propia url.
Hay dos detalles que importan cuando trabaja con él. Primero, schema.org define lo que significa una propiedad, no si una función concreta de búsqueda la usa. Un tipo que no tiene una función de Google correspondiente sigue siendo vocabulario válido, y una página de una función de Google puede exigir propiedades que schema.org enumera como opcionales. Segundo, el vocabulario es el mismo sin importar el formato que elija, así que decidir entre JSON-LD y Microdata nunca cambia lo que significa headline.
Mantenga separados tres tipos de corrección. La sintaxis JSON puede ser válida mientras una propiedad se usa mal. Una propiedad puede ser válida en schema.org mientras una función de Google no la usa. Y un requisito de una función puede cumplirse mientras la página todavía no se muestra con una mejora de búsqueda.
Dónde encajan Open Graph y los microformatos
Open Graph y los microformatos a veces se agrupan con el marcado schema, porque también agregan significado a una página. Son vocabularios separados con funciones distintas. El protocolo Open Graph está diseñado para convertir páginas web en objetos enriquecidos dentro de un grafo social, y normalmente va en elementos <meta> dentro del <head>.
<meta property="og:title" content="Example Bakery">
<meta property="og:description" content="Pan fresco hecho cada mañana.">
<meta property="og:image" content="https://example.com/images/bakery.jpg">Open Graph controla sobre todo cómo se representa una página cuando alguien la comparte en una plataforma social. No reemplaza a schema.org para describir ante Google Search un artículo, un producto, un evento o una organización. Conserve ambos cuando importen las dos funciones, y asegúrese de que el título y la imagen digan lo mismo en cada lugar.
Los microformatos son patrones HTML ligeros que agregan significado al contenido visible mediante nombres de clase. La wiki de microformatos enumera patrones como h-card para personas y organizaciones, h-entry para publicaciones, h-event para eventos y h-product para productos. Usan vocabularios propios. Pueden convivir con el marcado de schema.org, pero describir el mismo elemento dos veces con valores contradictorios hace que la página sea más difícil de mantener y más probable que tenga errores.
Distintos consumidores leen cosas distintas. Bing Webmaster Tools indica que Bing admite schema.org en JSON-LD y Microdata, microformatos, RDFa y Open Graph, y que las anotaciones por sí solas no garantizan un resultado enriquecido (Bing Webmaster Tools). La documentación de Google cubre los datos estructurados de schema.org para las funciones de Google Search, así que Open Graph y los microformatos no los sustituyen en ese caso.
Los datos estructurados fuera de la búsqueda
«Datos estructurados» también describe tablas de bases de datos y eventos de analítica con atributos coherentes, y ninguno de los dos es marcado schema para sitios web. Cuando busque ayuda o dé instrucciones a un freelance y una solicitud solo diga «datos estructurados», pregunte si se refiere al marcado schema de schema.org en las páginas; si dice «schema», pregunte qué tipo y qué formato. Una sola pregunta aclaratoria ahorra una semana de trabajo en la capa equivocada.
Elija un formato: JSON-LD, Microdata o RDFa
Google recomienda en general JSON-LD y también admite Microdata y RDFa, salvo que una página de función diga lo contrario. Bing documenta la compatibilidad con JSON-LD, Microdata y RDFa y no declara preferencia entre ellos. Los tres pueden expresar información parecida, así que la elección práctica es la que pueda implementar y mantener con menor riesgo.
JSON-LD va en un único elemento script, separado del HTML visible. Eso facilita agregarlo mediante un tema, un administrador de etiquetas o un plugin, y leerlo en el código fuente de la página. Microdata y RDFa intercalan atributos en el HTML visible, así que el marcado queda ligado a los elementos exactos que muestran cada dato. Eso puede convenir a una plantilla que usted controla por completo, y puede ser más difícil de editar después.
Elija el que elija, use un solo formato para cada entidad de la página. Mezclar un Product en JSON-LD con Microdata que describe el mismo producto invita a duplicados y a discrepancias. Para una comparación más larga de los tres, lea JSON-LD, Microdata y RDFa comparados.
Revise lo que su página ya genera
Muchos temas, plugins y plataformas ya escriben marcado, así que lo primero es revisar, no pegar. Abra la página publicada, vea el código fuente o use las herramientas de desarrollo del navegador, y busque application/ld+json. Cada coincidencia es un bloque JSON-LD. Busque también itemscope e itemtype, que indican Microdata, y los atributos typeof o property, que indican RDFa.

La documentación de las plataformas confirma que esa salida ya puede existir. Squarespace indica que genera datos estructurados automáticamente para entradas de blog, eventos, negocios locales, organizaciones, productos y sitios web (Centro de ayuda de Squarespace). Wix describe JSON-LD manual, marcado predefinido y marcado de blog generado con IA, y menciona que es posible tener marcado duplicado (Centro de ayuda de Wix). HubSpot tiene un interruptor de esquema BlogPosting que viene activado de forma predeterminada en blogs más recientes, con una advertencia sobre duplicados (Base de conocimientos de HubSpot). Webflow le permite agregar esquema generado o manual en la configuración de la página (Centro de ayuda de Webflow).
Si la página ya tiene un bloque del mismo tipo, edite ese bloque en lugar de agregar un segundo. Los ajustes del tema y del plugin, como un grafo conectado desde un plugin de SEO, pueden ser el lugar correcto para cambiar un valor. La instalación paso a paso está en cómo agregar datos estructurados a un sitio web, y los detalles específicos de WordPress están en datos estructurados en WordPress.
Agregue una entidad con un ejemplo de BlogPosting
Una vez que sepa qué existe, agregue o edite una sola entidad y asegúrese de que coincida con lo que ven los visitantes. El ejemplo siguiente es un bloque BlogPosting completo para un artículo ficticio sobre una panadería. Es código didáctico con valores de example.com, por eso se muestra aquí y nunca debe ir en su página tal como está.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"@id": "https://example.com/blog/sourdough-basics/#article",
"url": "https://example.com/blog/sourdough-basics/",
"headline": "Fundamentos del pan de masa madre para principiantes",
"description": "Una guía ficticia para principiantes sobre cómo hacer pan de masa madre en casa.",
"image": [
"https://example.com/images/sourdough-1x1.jpg",
"https://example.com/images/sourdough-4x3.jpg",
"https://example.com/images/sourdough-16x9.jpg"
],
"datePublished": "2026-05-04T09:00:00-05:00",
"dateModified": "2026-05-18T14:30:00-05:00",
"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"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/blog/sourdough-basics/"
},
"articleSection": "Baking Guides",
"inLanguage": "es"
}
</script>Reemplace cada valor con información que aparezca en su página. El headline debe coincidir con el titular visible, datePublished y dateModified deben ser las fechas reales con la zona horaria correcta, author debe nombrar al autor real como persona u organización, e image debe enumerar imágenes que correspondan al artículo. No agregue calificaciones, reseñas, precios, direcciones ni autores que la página no muestre.
Para producir un bloque para su propio artículo sin escribir las llaves a mano, use el generador de schema para artículos, y luego compare el resultado con lo que ya imprime su plataforma. Si necesita ejemplos más completos de otros tipos, la guía sobre ejemplos de schema JSON-LD los cubre, y la de tipos de marcado schema le ayuda a elegir el tipo correcto.
Qué propiedades enumera la documentación de Google para artículos
La documentación de datos estructurados de artículos de Google cubre Article, NewsArticle y BlogPosting, y no lista propiedades obligatorias para ellos. Sí recomienda propiedades que se aplican a las páginas de artículos, incluidas author, headline, image, datePublished y dateModified. Dentro de un objeto author, name es necesario cuando incluye al autor, y se recomienda una url que apunte a una página que identifique al autor.
Las demás propiedades del ejemplo, como @id, url, description, publisher, mainEntityOfPage, articleSection e inLanguage, son propiedades opcionales compatibles con schema.org. Son una buena práctica cuando son exactas, y ayudan a mantener un grafo conectado en todo el sitio, pero no forman parte de la lista recomendada por Google para esta función.
Distinga bien las etiquetas. «Obligatorio», «recomendado» y «opcional» describen la documentación de función de un consumidor específico, no la definición general del tipo en schema.org. Una propiedad recomendada no garantiza ninguna mejora de búsqueda, y omitirla no vuelve inválido el marcado.
Valide y mantenga visibles los hechos
Valide antes de publicar y de nuevo después de cualquier cambio en la plantilla. Una revisión de sintaxis le indica que el JSON se analiza correctamente. Las revisiones de vocabulario le indican si los tipos y las propiedades existen. Una prueba de función, como la Prueba de resultados enriquecidos de Google para los tipos compatibles, muestra si se cumplen los requisitos de una función específica de Google. Puede ejecutar las dos primeras con el validador de Schema Nova y revisar páginas publicadas con el comprobador de Schema Nova.
Las directrices generales de datos estructurados de Google piden que el marcado refleje contenido que los visitantes pueden ver, que siga siendo exacto y que sea relevante para la página. Los datos ocultos o los detalles que no coinciden con la página incumplen esa expectativa. Las mismas directrices dicen que el marcado válido no garantiza un resultado enriquecido, y Bing dice lo mismo sobre sus anotaciones.
Después de publicar, mantenga el marcado al día. Cuando cambie un precio, una fecha, un autor o un título en la página, cámbielo en el marcado en la misma edición. Si usa Google Search Console, sus informes de datos estructurados pueden mostrar problemas en los tipos compatibles que supervisa.
Para una lista larga de comprobaciones, consulte la documentación de Google de la función exacta a la que apunta. La documentación de una función no describe otra, y la página que está marcando determina cuál se aplica.
Lo que Google todavía muestra
La compatibilidad con las funciones cambia, así que trate cualquier lista de resultados enriquecidos como información con fecha. Google indica que dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026 y que eliminó la documentación de esa función en junio de 2026. FAQPage sigue siendo un tipo válido de schema.org, y el contenido de preguntas frecuentes sigue ayudando a los lectores cuando coincide con la página visible, pero no debe agregarlo para obtener un resultado enriquecido de Google.
El anuncio de agosto de 2023 de Google eliminó los resultados enriquecidos de How-to (instrucciones) de Search en computadoras y dispositivos móviles. Su publicación de octubre de 2024 eliminó el cuadro de búsqueda de enlaces de sitio a partir del 21 de noviembre de 2024, y mantuvo la compatibilidad con datos estructurados WebSite relacionados con el nombre del sitio. Su publicación de junio de 2025 retiró gradualmente la visualización de funciones como Course Info, ClaimReview, Estimated Salary, Learning Video, Special Announcement y Vehicle Listing.
Esos cambios afectan a las presentaciones de Google Search. No cambian el vocabulario de schema.org, y otros sistemas que leen schema.org pueden usarlo de forma distinta. Revise la página de actualizaciones de la documentación de Google para la función a la que apunta antes de invertir tiempo en un tipo.
El orden práctico sigue siendo el mismo: mire lo que la página ya genera, elija el tipo que coincide con el contenido visible, escríbalo en un formato que pueda mantener, valídelo y manténgalo exacto. Si quiere el lado SEO de esto, la guía sobre si el marcado schema ayuda al SEO explica las expectativas con detalle.
Preguntas frecuentes
¿Son lo mismo el marcado schema y los datos estructurados?
Se superponen, pero los datos estructurados son la categoría más amplia. El marcado schema es un tipo de datos estructurados que usa el vocabulario de schema.org, y la gente suele decir una cosa cuando quiere decir la otra porque Google Search usa principalmente schema.org para los datos estructurados de sitios web.
¿JSON-LD es lo mismo que el marcado schema?
No. JSON-LD es un formato para escribir datos, y el marcado schema es lo que obtiene al escribir vocabulario de schema.org en él. En cambio, puede escribir el mismo marcado schema en Microdata o en RDFa.
¿Open Graph puede reemplazar el marcado schema?
No. Open Graph describe cómo aparece una página cuando se comparte en plataformas sociales, mientras que schema.org describe el contenido de la página para sistemas como Google Search. Muchas páginas llevan ambos para funciones separadas.
¿Toda página necesita marcado schema?
Agregue marcado cuando describa con exactitud la página y encaje con una función compatible o con un uso relevante. Omita los hechos no relacionados u ocultos, porque el marcado que no coincide con la página visible puede causar problemas.
¿El marcado de preguntas frecuentes sigue siendo válido?
FAQPage sigue siendo un tipo válido de schema.org. Google indica que dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026, así que agregue marcado de preguntas frecuentes solo cuando refleje con exactitud preguntas y respuestas visibles, no para obtener una visualización en Google.
