Use JSON-LD para el marcado nuevo y conserve los microdatos o RDFa precisos que ya funcionan. La introducción a los datos estructurados de Google (última actualización el 10 de diciembre de 2025) recomienda JSON-LD porque, en general, es más fácil de implementar, mantener y escalar, y también incluye los microdatos y RDFa como formatos compatibles.

Las pautas de datos estructurados de Bing indican que admite JSON-LD, microdatos y RDFa, y que no prefiere ninguno. El formato por sí solo no determina si una página puede calificar para una función de Google. El contenido debe ser preciso, estar visible en la página y cumplir los requisitos de esa función.

Trabaje en este orden. Revise qué genera ya su plataforma, elija un formato para cada entidad y plantilla, migre el marcado antiguo por etapas si lo necesita y pruebe la página renderizada. Los ejemplos usan una panadería ficticia en example.com, así que puede comparar los tres formatos con la misma información.

Puntos clave

  1. Use JSON-LD para el marcado nuevoGoogle recomienda JSON-LD porque, en general, es más fácil de implementar, mantener y escalar. Conserve el Microdata o RDFa exacto que ya funciona.
  2. El formato no decide la elegibilidadBing indica que admite los tres formatos. Una función de Google depende del contenido visible exacto y de sus propios requisitos, no del formato.
  3. Revise primero lo existenteBusque application/ld+json, itemscope y typeof en el HTML renderizado para encontrar el marcado ya presente. El Microdata o RDFa exacto que exista puede quedarse.
  4. Elija por entidad y plantillaDecida por entidad y plantilla, no para todo el sitio. Los valores en conflicto en una página son el verdadero problema, así que dé a cada entidad una sola descripción.
  5. Migre por etapasLa migración es opcional. Si cambia de formato, hágalo una plantilla cada vez y retire el formato antiguo solo cuando JSON-LD cubra los mismos datos.
  6. Pruebe la página renderizadaPruebe la URL publicada, no solo el código pegado. La Prueba de resultados enriquecidos de Google acepta los tres formatos, y superarla no garantiza un resultado enriquecido.

Busque el marcado que ya tiene su página

Antes de agregar nada, revise la página en vivo. Ábrala en un navegador, vea el código fuente de la página y busque tres indicadores. Un elemento <script type="application/ld+json"> indica que hay JSON-LD. Los atributos itemscope, itemtype e itemprop indican microdatos. Los atributos vocab, typeof y property indican RDFa.

Revise también la página renderizada, además del código fuente, porque un tema, un plugin, una aplicación o un script puede agregar marcado después de que el servidor envía el primer HTML. La introducción de Google describe el marcado que se inserta dinámicamente, así que el inspector del navegador es el lugar adecuado para mirar. Anote qué plantillas contienen marcado y qué tipos de entidades describen, como el negocio, un producto o un artículo.

Si encuentra marcado, no suponga que es incorrecto. Los microdatos o RDFa precisos que una plataforma genera correctamente pueden quedarse en su lugar. Si no encuentra nada, está eligiendo un formato para marcado nuevo, y JSON-LD es la respuesta habitual.

Qué cambian los tres formatos

Schema.org es el vocabulario compartido. Define tipos, como Bakery, y propiedades, como telephone. JSON-LD, microdatos y RDFa son tres maneras de escribir la misma descripción con ese vocabulario. La guía de primeros pasos de Schema.org publica sus ejemplos en las tres sintaxis. Para las definiciones más amplias, consulte las guías sobre qué es el marcado schema y sobre marcado schema frente a datos estructurados.

JSON-LD coloca la entidad en un objeto JSON separado dentro de un elemento script. No agrega atributos al HTML visible, así que un rediseño de la plantilla no rompe los datos. La Recomendación JSON-LD 1.1 del W3C (16 de julio de 2020) lo define como un formato basado en JSON para serializar datos enlazados.

Los microdatos y RDFa funcionan al revés. Agregan atributos directamente a los elementos visibles, así que cada propiedad queda unida al texto o al enlace que describe. Los microdatos usan itemscope, itemtype e itemprop. RDFa usa vocab, typeof, property y resource, y ofrece capacidades de datos enlazados más amplias que los microdatos. Esa unión es útil cuando una plataforma ya la genera, y un costo cuando las plantillas cambian con frecuencia.

Una panadería en tres formatos

Los tres ejemplos describen la misma panadería ficticia, Example Bakery. Los tipos y las propiedades coinciden con la página de la función datos estructurados de negocio local de Google. Bakery es un subtipo de LocalBusiness. Para esa función de Google, name y address son las propiedades obligatorias, y url, telephone, geo, openingHoursSpecification, priceRange y servesCuisine se recomiendan para un establecimiento de comida. Reemplace cada valor ficticio por información que aparezca en su propia página.

JSON-LD

Pegue este código en el head o en el body de la página. Cambie el @id, el nombre, la dirección, el teléfono, las coordenadas, el rango de precios y el horario. Mantenga estable el @id, porque es el identificador que reutiliza si otro marcado del sitio se refiere al mismo negocio.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Bakery",
  "@id": "https://example.com/#bakery",
  "name": "Example Bakery",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Example Street",
    "addressLocality": "Example City",
    "addressRegion": "EX",
    "postalCode": "00000",
    "addressCountry": "US"
  },
  "url": "https://example.com/",
  "telephone": "+1-555-010-0000",
  "servesCuisine": "Bakery",
  "priceRange": "$$",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 40.00000,
    "longitude": -75.00000
  },
  "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>

Microdatos

La misma información, como atributos en los elementos visibles. El encabezado, la dirección, el enlace y el número de teléfono son el texto que leen los visitantes, así que edite esos elementos en su plantilla y mantenga los atributos en ellos. Un elemento meta contiene un valor que no se muestra, así que confirme que la misma información aparezca en algún lugar de la página.

html
<div itemscope itemtype="https://schema.org/Bakery" itemid="https://example.com/#bakery">
  <h1 itemprop="name">Example Bakery</h1>

  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">123 Example Street</span>,
    <span itemprop="addressLocality">Example City</span>,
    <span itemprop="addressRegion">EX</span>
    <span itemprop="postalCode">00000</span>
    <meta itemprop="addressCountry" content="US">
  </div>

  <a itemprop="url" href="https://example.com/">example.com</a>
  <a itemprop="telephone" href="tel:+15550100000">+1-555-010-0000</a>
  <meta itemprop="servesCuisine" content="Bakery">
  <meta itemprop="priceRange" content="$$">

  <div itemprop="geo" itemscope itemtype="https://schema.org/GeoCoordinates">
    <meta itemprop="latitude" content="40.00000">
    <meta itemprop="longitude" content="-75.00000">
  </div>

  <div itemprop="openingHoursSpecification" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
    <meta itemprop="dayOfWeek" content="Monday">
    <meta itemprop="dayOfWeek" content="Tuesday">
    <meta itemprop="dayOfWeek" content="Wednesday">
    <meta itemprop="dayOfWeek" content="Thursday">
    <meta itemprop="dayOfWeek" content="Friday">
    <meta itemprop="opens" content="07:00">
    <meta itemprop="closes" content="17:00">
  </div>

  <div itemprop="openingHoursSpecification" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
    <meta itemprop="dayOfWeek" content="Saturday">
    <meta itemprop="dayOfWeek" content="Sunday">
    <meta itemprop="opens" content="08:00">
    <meta itemprop="closes" content="15:00">
  </div>
</div>

RDFa

RDFa sigue la misma forma con nombres de atributo distintos. El atributo vocab nombra el vocabulario una sola vez, typeof reemplaza a itemtype y property reemplaza a itemprop. El atributo resource lleva el identificador que itemid y @id llevan en los otros dos ejemplos.

html
<div vocab="https://schema.org/" typeof="Bakery" resource="https://example.com/#bakery">
  <h1 property="name">Example Bakery</h1>

  <div property="address" typeof="PostalAddress">
    <span property="streetAddress">123 Example Street</span>,
    <span property="addressLocality">Example City</span>,
    <span property="addressRegion">EX</span>
    <span property="postalCode">00000</span>
    <meta property="addressCountry" content="US">
  </div>

  <a property="url" href="https://example.com/">example.com</a>
  <a property="telephone" href="tel:+15550100000">+1-555-010-0000</a>
  <meta property="servesCuisine" content="Bakery">
  <meta property="priceRange" content="$$">

  <div property="geo" typeof="GeoCoordinates">
    <meta property="latitude" content="40.00000">
    <meta property="longitude" content="-75.00000">
  </div>

  <div property="openingHoursSpecification" typeof="OpeningHoursSpecification">
    <meta property="dayOfWeek" content="Monday">
    <meta property="dayOfWeek" content="Tuesday">
    <meta property="dayOfWeek" content="Wednesday">
    <meta property="dayOfWeek" content="Thursday">
    <meta property="dayOfWeek" content="Friday">
    <meta property="opens" content="07:00">
    <meta property="closes" content="17:00">
  </div>

  <div property="openingHoursSpecification" typeof="OpeningHoursSpecification">
    <meta property="dayOfWeek" content="Saturday">
    <meta property="dayOfWeek" content="Sunday">
    <meta property="opens" content="08:00">
    <meta property="closes" content="15:00">
  </div>
</div>

Observe cuánto HTML hay que modificar en el segundo y en el tercer ejemplo. El bloque JSON-LD deja su plantilla intacta, mientras que los microdatos y RDFa dependen de que la estructura de los elementos se mantenga. Esa diferencia explica gran parte del argumento sobre el mantenimiento.

Para obtener una versión lista de esta entidad, el generador de schema para negocio local crea JSON-LD a partir de la información que usted ingresa. Para más tipos y código para copiar, consulte los ejemplos de schema JSON-LD.

Propiedades de negocio local de Google que usa el ejemplo de la panadería

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

PropiedadClasificación para esta función de GoogleQué indicar
nameObligatoriaEl nombre del negocio tal como aparece en la página.
addressObligatoriaLa ubicación física del negocio, con calle, ciudad, región, código postal y país.
telephoneRecomendadaEl número de teléfono que los visitantes pueden ver en la página.
openingHoursSpecificationRecomendadaDías con horas de apertura (opens) y de cierre (closes) que coincidan con el horario de la página.
priceRangeRecomendadaUn rango de precios que coincida con lo que muestra la página.
servesCuisineRecomendada para un establecimiento de comidaEl tipo de cocina o de comida que sirve el negocio.

Quién lee cada formato

Google indica que admite JSON-LD, microdatos y RDFa, y que recomienda JSON-LD (introducción a los datos estructurados, última actualización el 10 de diciembre de 2025). Su Prueba de resultados enriquecidos (Rich Results Test) acepta los tres formatos (ayuda de la Prueba de resultados enriquecidos). La función de Google para la que puede calificar una página depende de la documentación de esa función, no del formato.

Bing indica que sus rastreadores admiten Schema.org en JSON-LD, microdatos HTML y RDFa, y que no prefieren una especificación compatible sobre otra. Esa afirmación se refiere al formato. No dice que los datos dentro puedan estar incompletos o ser inexactos, así que se aplica el mismo cuidado sin importar el formato que elija.

Schema.org en sí es neutral. Define el vocabulario y muestra ejemplos en las tres sintaxis. Una recomendación de formato de un buscador describe a ese buscador, y el consejo coherente de todos ellos es describir con precisión el contenido real y visible. Para los sistemas de búsqueda con IA, consulte ¿usa la IA el marcado schema?.

Elija un formato para cada entidad y plantilla

Decida por entidad y por plantilla, no una sola vez para todo el sitio. Un sitio puede usar JSON-LD para sus artículos y aun así dejar los microdatos de una plataforma en sus tarjetas de producto. El objetivo es que cada entidad de cada página tenga una única descripción canónica que usted pueda mantener actualizada.

  • JSON-LD encaja en implementaciones nuevas, plantillas de CMS, aplicaciones JavaScript y sitios grandes.
  • Los microdatos encajan en una plataforma que ya los genera correctamente, o en un marcado que debe seguir unido al HTML visible.
  • RDFa encaja en un sistema existente de HTML semántico o de datos enlazados que ya depende de él.

El mantenimiento es la diferencia práctica. JSON-LD tiene un acoplamiento bajo con la plantilla y, por lo general, es fácil de leer, copiar, comparar y validar como un solo objeto. Los microdatos están muy acoplados a los elementos HTML, así que un cambio de plantilla puede romper la cobertura sin que se note, y los errores pueden repartirse entre marcado anidado. RDFa queda entre los dos en acoplamiento, y su flexibilidad exige más a quien no trabaja con datos enlazados.

Publicar dos formatos para la misma entidad no es automáticamente un problema. Los valores en conflicto sí lo son, porque dificultan la interpretación de la página. Es una práctica de implementación que se deriva de las directrices generales de Google sobre datos estructurados (el marcado debe describir contenido visible y relevante) y de la forma en que funcionan los identificadores de JSON-LD, no de una regla de penalización aparte de Google. Cuando la misma entidad aparece en más de un objeto, asígnele un @id estable y mantenga idénticos los nombres, las URL, las direcciones, los precios, la disponibilidad y las fechas.

Migre los microdatos o RDFa heredados por etapas

La migración es opcional. Si el marcado existente es preciso y su plataforma lo mantiene actualizado, dejarlo como está es una decisión sólida. Pase a JSON-LD cuando el marcado antiguo sea difícil de mantener, cuando las plantillas lo sigan rompiendo o cuando necesite agregar tipos que la plataforma no genera.

Un hombre con polo gris y lentes está de pie frente a un escritorio de altura regulable en un estudio de garaje convertido, mirando un monitor
Figura 1. Migrar una plantilla a la vez mantiene un error limitado a un grupo pequeño de páginas.

Migre una plantilla a la vez, para que un error afecte a un grupo pequeño de páginas y no a todo el sitio.

  1. Haga un inventario de los microdatos o RDFa por plantilla de página y tipo de entidad.
  2. Compare cada entidad y propiedad con la documentación de la función de Búsqueda de Google correspondiente.
  3. Cree un JSON-LD equivalente con la misma información, las mismas URL, los mismos identificadores y las mismas relaciones.
  4. Valide el JSON-LD con la Prueba de resultados enriquecidos y con Schema Markup Validator (validador de marcado de Schema.org).
  5. Publíquelo en un grupo pequeño de páginas representativas.
  6. Revise las URL en vivo y supervise Search Console después de que Google las vuelva a rastrear.
  7. Elimine el formato antiguo solo después de que el reemplazo cubra el mismo contenido elegible y de que la página renderizada siga siendo precisa.

Los pasos 3 y 7 concentran el riesgo. En el paso 3, copie los valores de los atributos existentes en lugar de volver a escribirlos, y reutilice el mismo @id que usaba el marcado antiguo, para que las referencias desde otros objetos sigan apuntando a una sola entidad. En el paso 7, compare la cobertura antigua y la nueva propiedad por propiedad, porque una propiedad que existía solo en el marcado antiguo desaparece en cuanto usted la elimina.

Si una plataforma ya genera microdatos para una página, no agregue por reflejo una segunda versión de JSON-LD escrita a mano. Agréguela solo después de confirmar que las dos descripciones no entran en conflicto ni duplican la misma entidad. Para los pasos de configuración independientes de la plataforma, consulte la guía sobre cómo agregar datos estructurados.

Revise lo que genera la plataforma antes de instalar nada

Las plataformas difieren en lo que ya generan y en lo que se puede editar, así que revise primero la página renderizada.

Los temas de Shopify pueden incluir microdatos para el contenido compatible del tema, así que vea el código fuente de una página de producto antes de agregar JSON-LD desde una aplicación o un fragmento de código. Squarespace genera automáticamente varios tipos de datos estructurados y señala que no se pueden editar ni eliminar, así que el marcado manual allí debe describir algo que la plataforma todavía no cubre.

Webflow permite agregar marcado schema manualmente en Page settings (configuración de la página) y en las Collection pages (páginas de colección), como describe su guía de marcado schema (actualizada el 27 de enero de 2026). La misma página indica que el marcado con código personalizado (custom code) puede seguir funcionando y recomienda evitar implementaciones duplicadas. WordPress.com admite datos estructurados mediante sus ajustes de SEO para algunos tipos y recomienda plugins para otros.

En un sitio hecho a mano, generar JSON-LD directamente en la página es sencillo. La documentación de Next.js recomienda usar una etiqueta script nativa en layout.js o page.js, y también aconseja sanitizar la salida serializada y validarla. Para sitios de WordPress con su propio tema o plugin, la guía de marcado schema en WordPress explica las rutas de instalación.

Pruebe la página renderizada

Cada prueba responde a una pregunta distinta, y ninguna prueba responde a todas. Una comprobación de sintaxis JSON indica que el código se analiza correctamente. El Schema Markup Validator de Schema.org revisa solo el vocabulario, así que un tipo o una propiedad puede pasar esa revisión y aun así no tener detrás ninguna función de Google. La Prueba de resultados enriquecidos de Google acepta los tres formatos e indica si el marcado cumple los requisitos de las funciones de Google que admite.

Ejecute la prueba contra la URL en vivo, no solo contra un fragmento pegado, para comprobar lo que reciben de verdad los visitantes y los rastreadores. El validador de Schema Nova sirve para revisar su JSON-LD antes de publicarlo. Después de publicar, revise la URL en vivo y supervise Search Console mientras Google vuelve a rastrear las páginas.

Dos tarjetas parecidas que se fusionan en una sola tarjeta alineada, unida al contorno de una página, en una ilustración abstracta
Figura 2. Una descripción canónica por entidad evita valores en conflicto en la misma página.

Pasar una prueba no garantiza un resultado enriquecido. Las directrices generales de Google indican que el marcado válido no promete ninguna apariencia particular en la búsqueda, y que Google puede no mostrar una función aunque todo se valide. Para saber hasta dónde llegan los datos estructurados en la búsqueda en general, lea si el marcado schema ayuda al SEO. Para elegir el tipo de entidad en sí, consulte la guía sobre los tipos de marcado schema.

Desde elegir el formato hasta supervisarlo

La validación confirma el procesamiento técnico. No garantiza un resultado enriquecido.

  1. Elija tipo y formatoSeleccione el tipo de entidad y luego un formato para esa entidad y plantilla.
  2. Agregue las propiedades obligatoriasIncluya las propiedades que exige la página de la función de Google correspondiente.
  3. Agregue propiedades recomendadasAgregue las propiedades recomendadas que correspondan al contenido.
  4. Coincida con la página visibleMantenga toda la información precisa y visible para los visitantes.
  5. ValidePruebe la página renderizada, no solo el código pegado.
  6. Publique y superviseRevise la URL en vivo y supervise Search Console después de que Google la vuelva a rastrear.

Preguntas frecuentes

¿Google admite microdatos y RDFa, o solo JSON-LD?

Google indica que admite JSON-LD, microdatos y RDFa, y que recomienda JSON-LD. Los microdatos o RDFa existentes pueden permanecer si son precisos y funcionan. Revise la página de la función específica para ver las propiedades que esa función requiere.

¿JSON-LD y microdatos pueden describir la misma página?

Sí, pero los valores en conflicto dificultan la interpretación de la página, y una sola descripción canónica es más fácil de mantener. Si conserva ambos, use la misma información y el mismo @id para la misma entidad, y confirme que no dupliquen la entidad. Si una plataforma ya genera microdatos, pruebe su resultado antes de agregar una copia manual.

¿Los visitantes ven JSON-LD?

El elemento script no se muestra en la página. Aun así, la información que contiene debe coincidir con el contenido que los visitantes pueden ver, porque las directrices de Google exigen que los datos estructurados describan contenido visible y relevante.

¿Por qué mi marcado es válido pero no aparece como resultado enriquecido?

El marcado válido es una condición previa para una función, no una promesa de que aparecerá. Google decide si muestra una apariencia en la búsqueda, y algunas funciones ya no existen. Google dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026, y FAQPage sigue siendo un tipo válido de Schema.org. El anuncio de Google de agosto de 2023 retiró los resultados enriquecidos de HowTo. Revise la galería de funciones para saber qué admite Google actualmente.

¿Qué debe revisar un propietario de Shopify o Squarespace antes de agregar marcado manual?

Revise el código fuente de la página renderizada para ver lo que ya genera el tema o la plataforma. Después, agregue solo los tipos que falten y asigne a cada entidad que ya tenga marcado una sola descripción, en lugar de una segunda.

Comprobación rápida: vocabulario y formato

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

Pregunta 1 de 3

¿Cuál es el vocabulario: Schema.org o JSON-LD?

Pregunta 2 de 3

¿Qué formatos asocian propiedades directamente con elementos HTML visibles?

Pregunta 3 de 3

Una plataforma ya genera microdatos correctos y funcionales. ¿Qué sigue?

Términos usados al decidir el formato

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

Schema.org. Un vocabulario compartido de tipos y propiedades para describir cosas de una página.