El marcado schema es código que describe de qué trata una página, usando el vocabulario compartido de Schema.org. La mayoría de quienes administran un sitio lo escriben como JSON-LD, un bloque de texto estructurado que se coloca dentro de una etiqueta <script type="application/ld+json">. El marcado debe describir datos que los visitantes ya pueden ver en la página, como el nombre de un negocio, su dirección y su horario de atención.

Tres términos suelen aparecer juntos. Schema.org es el vocabulario de tipos y propiedades, JSON-LD es un formato para escribir ese vocabulario, y los datos estructurados son la idea más amplia de dar al contenido de una página una estructura legible por máquinas. El negocio de ejemplo aquí es una panadería ficticia.

Si quiere un borrador inicial, el generador de schema para negocio local crea este tipo de bloque a partir de los datos que usted ingrese. Antes de agregar algo a un sitio publicado, revise lo que ya genera su tema, su creador de sitios web o su aplicación, porque una segunda descripción del mismo negocio puede entrar en conflicto con la primera.

Puntos clave

  1. Qué es el marcado schemaEl marcado schema es código, normalmente JSON-LD, que describe de qué trata una página usando el vocabulario de Schema.org. Debe coincidir con los datos que los visitantes ya pueden ver.
  2. Revise antes de pegarCompruebe lo que generan su tema, su constructor de sitios o su aplicación antes de añadir nada, porque una segunda descripción del mismo negocio puede chocar con la primera.
  3. Use el tipo específicoElija el tipo aplicable más específico, como Bakery en lugar de LocalBusiness, e introduzca solo datos que aparezcan en la página.
  4. Requerido por quiénPara la función Local Business de Google, name y address son obligatorias, mientras que url, telephone y openingHoursSpecification son recomendadas cuando corresponden.
  5. Sin promesa de visualizaciónUn marcado correcto no garantiza un resultado enriquecido, y una prueba superada solo significa que el marcado cumple los requisitos que esa prueba cubre.
  6. Pruebe y actualicePruebe con la Prueba de resultados enriquecidos y el Validador de marcado Schema, y luego actualice el JSON-LD en la misma edición cada vez que cambien los datos visibles.

Schema.org, JSON-LD y datos estructurados: cómo encajan los términos

Muchas personas usan «schema», «marcado schema», «datos estructurados» y «JSON-LD» casi como sinónimos, así que conviene ubicar cada uno. Los datos estructurados son información legible por máquinas que da al contenido de una página una estructura y un significado definidos. Google explica cómo trabaja con esa información en su introducción al marcado de datos estructurados (documentación actualizada en diciembre de 2025).

Schema.org es un vocabulario compartido de tipos y propiedades. Un tipo nombra una clase de cosa, como Organization o LocalBusiness, y una propiedad es un detalle sobre ella, como name, address o telephone. A cada cosa individual que se describe se le llama entidad: esta panadería, ese producto, este autor.

JSON-LD, Microdata y RDFa son formatos, tres maneras de escribir el vocabulario. JSON-LD es un formato basado en JSON para datos enlazados, definido en una Recomendación del W3C. Microdata incrusta atributos dentro del HTML visible, y RDFa es una extensión de HTML para datos enlazados. Google indica que recomienda JSON-LD cuando su configuración lo permite, porque en general es más fácil de implementar y mantener. La documentación de Bing indica que Bing admite marcado de Schema.org en JSON-LD, Microdata y RDFa. JSON-LD vs Microdata vs RDFa compara los tres con más detalle.

En conjunto, Schema.org aporta las palabras, un formato como JSON-LD las escribe y el resultado son datos estructurados. «Marcado schema» es el nombre cotidiano de los datos estructurados de Schema.org, sobre todo cuando se escriben en JSON-LD. Los matices de la terminología se explican en Marcado schema vs datos estructurados.

Ilustración de fichas brillantes con formas, un contenedor en forma de corchete y una tarjeta de página unidos por líneas azules delgadas
Figura 1. Un vocabulario compartido, un formato para escribirlo y la página que describe funcionan juntos como datos estructurados.

Un primer ejemplo de JSON-LD para una panadería

El bloque útil más pequeño para una panadería ficticia en example.com se ve así. La etiqueta script envuelve el marcado, y el JSON entre las llaves es la descripción en sí.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Example Bakery",
  "url": "https://example.com/",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Example Street",
    "addressLocality": "Example City",
    "addressRegion": "IL",
    "postalCode": "60601",
    "addressCountry": "US"
  }
}
</script>

Léalo línea por línea. @context indica el vocabulario, aquí https://schema.org, para que un analizador sepa qué significan las palabras. @type dice qué clase de cosa se describe, y en este caso es un LocalBusiness. name y url dan el nombre del negocio y su sitio web. address contiene un objeto anidado de tipo PostalAddress con la calle, la ciudad, la región, el código postal y el país, y cada objeto anidado lleva su propio @type para que un analizador sepa cómo leer los campos que contiene.

Todos los valores de arriba son inventados. Reemplace el nombre, la URL y la dirección por los datos de su propia página, y mantenga cada valor idéntico a lo que el visitante lee allí. Si la página muestra un nombre de negocio o un número de calle distinto, el marcado debe mostrar el mismo.

Agregar horario, teléfono y un tipo más específico

Una versión más completa cambia LocalBusiness por Bakery, un subtipo más específico, y agrega un identificador estable, una imagen, un número de teléfono, un rango de precios y el horario de atención. Google recomienda usar el subtipo de LocalBusiness más específico que corresponda, según su documentación de datos estructurados de Local Business.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Bakery",
  "@id": "https://example.com/#bakery",
  "name": "Example Bakery",
  "url": "https://example.com/",
  "image": "https://example.com/images/example-bakery.jpg",
  "telephone": "+1-312-555-0147",
  "priceRange": "$$",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Example Street",
    "addressLocality": "Example City",
    "addressRegion": "IL",
    "postalCode": "60601",
    "addressCountry": "US"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "opens": "07:00",
      "closes": "17:00"
    },
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": [
        "Saturday",
        "Sunday"
      ],
      "opens": "08:00",
      "closes": "15:00"
    }
  ]
}
</script>

Varios valores necesitan sus propios datos antes de publicar esto. Escriba en telephone el número real, con su código de país, ya que el de arriba es inventado. Apunte image a una foto de su propio sitio que represente al negocio, y mantenga priceRange breve y exacto, dentro del límite de longitud que indica Google. Actualice las dos entradas de openingHoursSpecification para que los días y las horas coincidan con el horario que aparece en la página. El ejemplo usa reloj de 24 horas, con días laborables de 07:00 a 17:00 y fines de semana de 08:00 a 15:00.

@id es opcional. Da a la entidad un identificador estable, una URL más un nombre de fragmento que usted elige, para que otro marcado de su sitio pueda referirse al mismo negocio sin describirlo dos veces. La página visible debe mostrar el mismo nombre, dirección, número de teléfono y horario que contiene el marcado.

Propiedades obligatorias y recomendadas

La palabra «obligatorio» siempre necesita un «según quién». Schema.org en sí hace obligatorias muy pocas propiedades. En cambio, la página de una función de Google enumera las propiedades que una página necesita para ser elegible para esa función, y las separa de las recomendadas. Para LocalBusiness, la documentación de Local Business de Google indica que name y address son obligatorias. Entre las recomendadas cuando corresponden, enumera url, telephone, image, openingHoursSpecification, priceRange y geo.

Los tipos sin una función de Google correspondiente funcionan de otra manera. La documentación de datos estructurados de Organization de Google no enumera propiedades obligatorias para Organization y recomienda agregar los datos que correspondan, como nombre, dirección, URL, logotipo y datos de contacto. Un tipo de Schema.org que no tiene una función en Google no es inválido; simplemente no tiene requisitos de Google que cumplir.

Las propiedades de reseñas son condicionales. review y aggregateRating solo corresponden donde los requisitos de fragmentos de reseñas de Google lo permiten, y las reseñas deben ser visibles en la página. Nunca agregue calificaciones que la página no muestre.

También conviene distinguir cuatro significados de «correcto». El JSON puede tener una sintaxis válida. Los tipos y propiedades pueden ser vocabulario válido de Schema.org. El marcado puede cumplir los requisitos de una función de Google que todavía existe. Y la página puede estar indexada y mostrarse realmente con una mejora. Cada una es una pregunta distinta, y superar una no responde a la siguiente.

Propiedades de LocalBusiness de un vistazo

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadEstado en la documentación de Local Business de GoogleQué hacer
nameObligatoriaUse el nombre del negocio que aparece en la página.
addressObligatoriaUse la dirección física del negocio.
urlRecomendada cuando correspondaUse la URL canónica de la página.
telephoneRecomendada cuando correspondaIncluya el código de país y de área.
openingHoursSpecificationRecomendada cuando correspondaMantenga el horario actualizado y de acuerdo con la página.
aggregateRatingCondicionalÚselo solo cuando las calificaciones se recopilen legítimamente y cumplan los requisitos de reseñas de Google.

Haga que el marcado sea legible para Google y Bing

Google indica que usa los datos estructurados para entender el contenido de la página y para reunir información sobre las entidades descritas en el marcado (introducción a los datos estructurados, actualizada en diciembre de 2025). También puede usar el marcado para decidir si una página es elegible para un resultado enriquecido, una presentación mejorada como la información de productos, las rutas de navegación o los datos de negocios locales. Ser elegible significa que la página cumple los requisitos documentados de una función, no que la función vaya a aparecer. La galería de búsqueda de datos estructurados compatibles de Google enumera las funciones compatibles.

La página Cómo marcar su sitio con datos estructurados de Bing cubre el marcado de Schema.org en JSON-LD, Microdata y RDFa, así que el mismo bloque JSON-LD sirve para ambos buscadores. La tarjeta «Markup» (marcado) de la herramienta «URL Inspection» (inspección de URL) de Bing Webmaster Tools muestra qué marcado encontró Bing en una página. Para la búsqueda con IA, mantenga las páginas rastreables y el marcado preciso; la guía sobre si los sistemas de IA usan el marcado schema cubre cada sistema.

Dónde terminan las funciones de búsqueda y empiezan las promesas

Un marcado correcto no garantiza un resultado enriquecido. Las directrices generales sobre datos estructurados de Google lo dicen así, y el centro de ayuda de Wix hace la misma aclaración sobre sus propias herramientas de marcado. Superar la Prueba de resultados enriquecidos (Rich Results Test) tampoco garantiza que el resultado se muestre, y Google decide si muestra el marcado elegible y cómo lo hace.

Los datos estructurados tampoco garantizan el posicionamiento, y no pueden crear datos que la página no contiene. Las reseñas falsas, el contenido oculto, las afirmaciones engañosas y el marcado irrelevante pueden hacer que una página no sea elegible para una función. Para una respuesta más extensa sobre el rendimiento en búsquedas, lea ¿Sirven los datos estructurados para el SEO?

El soporte de funciones individuales también cambia. Google anunció que los resultados enriquecidos de HowTo dejaron de aparecer en la Búsqueda a partir de septiembre de 2023 (Cambios en los resultados enriquecidos de HowTo y de preguntas frecuentes). Eliminó el cuadro de búsqueda de enlaces de sitio desde el 21 de noviembre de 2024 (Adiós al cuadro de búsqueda de enlaces de sitio). En junio de 2025 anunció que se estaban eliminando gradualmente algunas funciones de datos estructurados seleccionadas, y dijo que el cambio no afecta el posicionamiento (Simplificando la página de resultados de búsqueda).

Los resultados enriquecidos de preguntas frecuentes dejaron de mostrarse en la Búsqueda de Google en mayo de 2026, y la documentación de esa función se eliminó en junio de 2026. FAQPage sigue siendo un tipo válido de Schema.org, así que el marcado de preguntas frecuentes existente no es inválido, pero ya no es una vía hacia una presentación en Google. Antes de crear marcado para cualquier función, abra la página de la función correspondiente de Google y la galería de búsqueda para ver qué está vigente.

Tipos de schema que usan los sitios pequeños

Empiece con el tipo que mejor describa el tema principal de la página, y agregue más solo cuando la página describa realmente cosas relacionadas. Los tipos siguientes cubren la mayoría de los sitios pequeños.

  • Organization: una empresa, organización sin fines de lucro, escuela o club, por lo general en la página de inicio o en la página Acerca de.
  • LocalBusiness: un negocio físico o una sucursal, con subtipos como Bakery.
  • Article o BlogPosting: contenido editorial y entradas de blog.
  • BreadcrumbList: la posición de una página dentro de la jerarquía del sitio.
  • Product con un Offer anidado: un producto con su precio y su disponibilidad.
  • Event: un evento con fechas, ubicación y datos de asistencia.
  • Recipe: ingredientes, tiempo de preparación y datos nutricionales.
  • Review o AggregateRating: solo en contextos donde las reseñas son elegibles.
  • WebSite: el sitio en su conjunto.
  • Person: un autor o una página de perfil.
  • Service: un servicio que ofrece un negocio u organización.

Combinar tipos relacionados es normal. La página de ubicación de una panadería puede describir la Bakery en sí, y una página de producto puede describir un Product cuyo Offer queda anidado dentro. No todos los tipos de esta lista tienen una función de Google, así que consulte la galería de búsqueda cuando el objetivo sea un resultado enriquecido. Tipos de marcado schema explica con más detalle la selección de tipos, y ejemplos de schema JSON-LD muestra bloques más completos.

Dónde vive el marcado y cómo verlo

Google admite JSON-LD en el <head> o en el <body> de una página HTML. El JSON-LD también puede insertarlo JavaScript o un sistema de gestión de contenidos. La documentación de código personalizado de Webflow describe cómo agregar etiquetas script al head o antes de la etiqueta de cierre de </body>, que es donde termina el JSON-LD colocado a mano en esa plataforma.

Para ver qué marcado ya tiene una página, siga estos pasos.

  1. Abra la página en un navegador.
  2. Use «View Source» (ver código fuente) o «Inspect» (inspeccionar).
  3. Busque application/ld+json.
  4. Copie cada bloque de JSON-LD en un validador.
  5. Compare los datos del marcado con la página visible.

«View Source» (ver código fuente) muestra el HTML que envió el servidor, y el panel «Elements» (Elementos) muestra el documento ya renderizado. Algunos sitios agregan JSON-LD después de que carga la página, así que revise en ambos lugares antes de decidir que una página no tiene marcado. Un dueño de un pequeño negocio puede terminar la comparación en unos minutos, en el mostrador: abra la página de ubicación, lea el bloque y confirme que el nombre, el horario y el número de teléfono coinciden con lo que ven los clientes.

Una persona que dirige una panadería señala la pantalla de una computadora que muestra una página web junto a un bloque de código, con bandejas de panecillos detrás
Figura 2. Comparar el marcado con la página visible confirma que el nombre, el horario y el número de teléfono coinciden.

Revise qué genera ya su plataforma

Muchas plataformas generan datos estructurados por usted, por eso conviene revisar la página publicada antes de pegar cualquier cosa. Squarespace indica que agrega datos estructurados automáticamente a las entradas de blog, eventos, negocios locales, organizaciones, productos y sitios web (Centro de ayuda de Squarespace). Wix acepta JSON-LD manual junto con su marcado preestablecido, y su artículo de ayuda sobre marcado de datos estructurados menciona un límite de cinco marcados, así que consulte ese artículo para ver los detalles vigentes.

Shopify expone datos estructurados de la información de productos mediante su filtro Liquid structured_data. En WordPress, lo que genera el tema y el plugin varía, y el código que construye JSON-LD en PHP puede usar wp_json_encode() para codificar los datos de forma segura. La guía de marcado schema en WordPress cubre esa vía. Los sitios construidos a mano pueden seguir el enfoque de la documentación de Next.js, que muestra JSON-LD en una etiqueta script nativa.

Las interfaces y el marcado automático cambian según el plan, el tema, la plantilla, la aplicación y el plugin. Revise primero la página publicada. Si ya existe un bloque para el mismo negocio, actualícelo en lugar de agregar otro. Cómo agregar datos estructurados a cualquier sitio web explica cómo colocar el marcado en cada tipo de sitio.

Pruebe el marcado y manténgalo actualizado

La Prueba de resultados enriquecidos de Google indica si el marcado cumple los requisitos de las funciones de Google que admite. El Schema Markup Validator revisa el código solo contra el vocabulario de Schema.org, sin los requisitos de las funciones de Google. También puede revisar el JSON-LD que pegue en el validador de schema de Schema Nova.

Superar una prueba significa que el marcado cumple los requisitos que esa prueba cubre. No significa que Google deba mostrar un resultado enriquecido, y no dice nada sobre el posicionamiento. Después de publicar, revise los informes de Search Console sobre las funciones que le interesan, y consulte lo que muestra Bing Webmaster Tools sobre las mismas páginas.

El marcado queda desactualizado en el momento en que cambia la página. Cuando la panadería modifique su hora de cierre del sábado o cambie su número de teléfono, actualice el JSON-LD en la misma edición que el texto visible. Trate el código como parte de la página, no como una tarea aparte que se termina una vez y se olvida.

Seis pasos de la página al marcado probado

Un orden seguro para agregar marcado schema a una página.

  1. 1. Identificar la entidadDecida qué describe principalmente la página, como un negocio, un producto o un artículo.
  2. 2. Elegir el tipoElija el tipo de Schema.org más específico que corresponda, como Bakery.
  3. 3. Usar datos visiblesIngrese datos exactos y visibles para los visitantes en la página.
  4. 4. Escribir el JSON-LDEscríbalo a mano o con un generador, y luego colóquelo en el head o en el body.
  5. 5. ProbarloUse la Prueba de resultados enriquecidos para las funciones de Google y el Schema Markup Validator para el vocabulario.
  6. 6. Publicar y mantenerRevise Search Console y actualice el marcado cuando cambie el contenido visible.

Preguntas frecuentes

¿Puedo agregar marcado schema sin programar?

Sí, de varias maneras. Un generador como el generador de schema para negocio local crea el JSON-LD a partir de los datos que usted ingresa, y Squarespace indica que agrega datos estructurados automáticamente para varios tipos de contenido. Aun así, pegue el código generado en un lugar que permita su plataforma, y compare el resultado con la página.

¿Necesito marcado schema en todas las páginas?

El marcado sigue el tema de cada página, así que una página lo necesita cuando un tipo encaja con su tema principal. Empiece por las páginas donde corresponda una función de Google documentada o una descripción precisa de su negocio, como una página de ubicación para un LocalBusiness o la página de inicio para una Organization. Las páginas sin un tipo adecuado pueden no llevarlo.

¿Qué schema necesita un negocio local?

Use el subtipo de LocalBusiness más específico que corresponda, como Bakery. Para la función Local Business de Google, name y address son obligatorias, y url, telephone, image, openingHoursSpecification y priceRange son recomendadas cuando corresponden. Complete solo lo que aparece en la página.

¿El marcado schema mejora el posicionamiento?

Los datos estructurados no garantizan el posicionamiento. El anuncio de Google de junio de 2025 indica que eliminar gradualmente algunas funciones de datos estructurados no afecta el posicionamiento. Los beneficios que sí ofrecen son una descripción de la página más clara para las máquinas, y la elegibilidad para presentaciones mejoradas donde Google las admite.

¿Qué pasa si el marcado schema tiene errores?

El marcado que describe contenido oculto, hace afirmaciones engañosas o agrega reseñas falsas puede hacer que una página no sea elegible para una función. Los errores de sintaxis y de vocabulario aparecen en el Schema Markup Validator, y las propiedades obligatorias que faltan aparecen en la Prueba de resultados enriquecidos. Corrija el código, vuelva a probarlo y publique la actualización.

Verificación rápida: vocabulario, formato y propósito

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

¿Cuál de estos elementos es un vocabulario?

Pregunta 2 de 3

¿Qué debe describir el marcado?

Pregunta 3 de 3

¿Qué significa una prueba aprobada?

Términos del marcado schema

Seleccione un término para ver su definición.

Marcado schema. Datos estructurados que usan el vocabulario de Schema.org.