Use Review para una reseña real de un solo elemento, visible en la página. Use AggregateRating para un promedio de varias calificaciones o reseñas que la página también muestre.

No use ninguno de los dos tipos en su propio sitio para que las reseñas de su negocio sean elegibles para las estrellas de reseñas de Google. Elija el tipo que coincida con lo que muestra la página, escriba el código y pruébelo.

El marcado válido puede hacer que una página sea elegible para un fragmento de reseñas, pero Google decide si muestra un resultado enriquecido y cuándo lo hace. Ningún marcado garantiza estrellas, posicionamiento, citas en sistemas de IA ni tráfico, así que el objetivo útil es un marcado preciso, que coincida con la página y cumpla las reglas de cada sistema que lo lee.

Las mismas reglas se aplican en WordPress, Shopify, Wix, Squarespace, Webflow y sitios hechos a mano, porque el marcado describe la página y no la plataforma.

Puntos clave

  1. Elija el tipo de marcadoUse Review para una reseña genuina de un solo artículo, y AggregateRating para un promedio que la página también muestre. Ambos deben ser visibles en la página.
  2. Omita las reseñas de autopromociónGoogle indica que las reseñas sobre su propio negocio en su sitio no son aptas para la función de estrellas de reseñas. Las reseñas de productos son un caso aparte.
  3. Conozca los campos obligatoriosPara una reseña independiente, Google exige author, itemReviewed y reviewRating. Las reseñas anidadas omiten itemReviewed, y los agregados necesitan ratingValue más reviewCount o ratingCount.
  4. Coincida con la páginaEl texto de la reseña, el promedio, los recuentos, la escala y el nombre del artículo deben aparecer en la página. Actualice el marcado si cambia la valoración visible.
  5. Mantenga las reseñas genuinasNo marque reseñas copiadas de Perfil de Empresa de Google ni de otro sitio web. Las directrices de Google también excluyen reseñas falsas e incentivadas sin declaración destacada.
  6. No espere estrellas garantizadasUna prueba superada confirma el análisis y las señales de elegibilidad documentadas. Google decide si mostrará un resultado enriquecido y cuándo, así que las estrellas nunca están garantizadas.

Elija Review o AggregateRating para la página

Un Review es la evaluación de una persona o de una organización sobre un elemento. Incluye un author, un reviewRating (un objeto Rating con un ratingValue) y, por lo general, el texto de reviewBody y un datePublished. Un cliente que escribe tres párrafos y da cuatro estrellas de cinco ha escrito un solo Review, y la página que muestra esa opinión es la página que hay que marcar con ella.

Un AggregateRating es el resultado combinado de muchas calificaciones. Incluye un ratingValue que es el promedio, además de un recuento y los extremos de la escala. Una página de producto que muestra «4.4 de 5 con 89 reseñas» describe un AggregateRating. Si una página muestra algunas opiniones individuales y el promedio de todas las calificaciones, la documentación de Google sobre fragmentos de reseñas indica que se incluya una calificación agregada basada en esas reseñas cuando sea apropiado.

Dos propiedades del tipo agregado causan la mayor parte de la confusión. Use reviewCount para el número de personas que enviaron reseñas escritas, y ratingCount para el número total de calificaciones, incluidas las que no tienen reseña escrita. Google exige al menos una de las dos. Use ambas cuando los dos números sean exactos y visibles, y mantenga cada una igual a lo que muestra la página.

La escala también importa. El valor predeterminado es de 1 a 5. Si su página usa otra escala, como de 1 a 10, indique bestRating y worstRating para que los números signifiquen lo que ven los visitantes. Escriba el promedio con punto decimal en JSON-LD, como 4.4, incluso si la página visible usa coma decimal.

Páginas en las que Google documenta fragmentos de reseñas

Google documenta fragmentos de reseñas para una lista fija de tipos de elemento: Book, Course list, Event, Movie, Product, Recipe, Software App, CreativeWorkSeason, CreativeWorkSeries, Episode, Game, MediaObject, MusicPlaylist y MusicRecording. Los negocios locales (LocalBusiness) y Organization están en la lista solo cuando el sitio recoge reseñas sobre otros negocios locales u otras organizaciones. Google documenta EmployerAggregateRating por separado para las reseñas de empleadores.

Cada reseña debe referirse a un elemento específico, no a una categoría ni a una lista. Una página que reseña «las mejores linternas» como grupo no es la reseña de un solo elemento, mientras que una página que reseña la Blue Lantern 4000 sí lo es. El elemento reseñado necesita un nombre, y las calificaciones deben venir directamente de los usuarios. No reúna calificaciones de otros sitios web para sumarlas en su página.

Si el tipo de su elemento no está en la lista de Google, Review y AggregateRating siguen siendo vocabulario válido de Schema.org, y otros sistemas pueden leerlos. Un objeto genérico no crea una función de Google para un tipo no compatible, así que no espere un fragmento de reseñas de Google a partir de él. Schema.org define Review y AggregateRating de forma independiente de cómo lo muestre cualquier buscador.

Reseñas de su propio negocio y reseñas de otros sitios

La orientación de Google del 18 de septiembre de 2019 sobre resultados enriquecidos de reseñas define una reseña autopromocional (self-serving) como una reseña sobre la entidad A colocada en el sitio web de la entidad A, ya sea escrita dentro del marcado o mostrada mediante un widget de terceros. Google indica que las páginas con esas reseñas no son elegibles para la función de estrellas de reseñas de LocalBusiness y Organization. La misma orientación indica que la regla por sí sola no provoca una acción manual y que no afecta al Perfil de Empresa de Google.

Imagine una tienda de alquiler de kayaks que recoge comentarios de clientes y los publica en su página principal. Marcarlos como reseñas de la tienda no hará que la página principal sea elegible para las estrellas de reseñas de Google, ya sea que los comentarios se escriban directamente o se incrusten desde un widget. Los comentarios siguen valiendo la pena para los visitantes. Lo que Google excluye es el marcado de reseñas sobre el propio negocio.

Un hombre de unos cincuenta años, con barba entrecana y camisa aloha, lee una computadora portátil en el escritorio de una tienda de alquiler de kayaks junto a la playa
Figura 1. Un dueño de tienda decide qué comentarios de clientes van en el marcado de reseñas y cuáles solo en la página.

La regla tiene un caso complementario claro. Un sitio de reseñas, un directorio o una publicación que reseña otros negocios puede marcar esas reseñas, porque el negocio reseñado es una entidad distinta del sitio. Las reseñas de productos que usted vende son un caso aparte: una página de producto puede incluir reseñas de ese producto, por eso los ejemplos siguientes usan un producto.

Copiar es el otro límite. No marque reseñas ni calificaciones que haya copiado del Perfil de Empresa de Google o de otro sitio web. Las directrices de Google también excluyen las reseñas falsas, y excluyen las reseñas incentivadas, salvo que el incentivo se declare de forma clara y destacada. El registro de cambios de la documentación de Google recoge esa directriz el 24 de julio de 2026, y la publicación del blog sobre la regla de Google para reseñas falsas e incentivadas explica qué cambió.

Propiedades que Google exige para cada tipo

Google divide las propiedades de los fragmentos de reseñas en obligatorias y recomendadas. Para un Review independiente, Google exige author, itemReviewed y reviewRating, y el elemento necesita un name. El fragmento de Product exige name más una de estas: review, aggregateRating u offers. Todo lo demás, como datePublished, reviewBody, bestRating y worstRating, es recomendado por Google, no obligatorio.

Estas etiquetas describen solo la función de Google. Una propiedad puede ser vocabulario válido de Schema.org sin que Google la exija, y un conjunto completo de propiedades no hace elegible a una página si el contenido incumple una directriz.

El anidamiento cambia una regla. Si una reseña está dentro de un elemento principal mediante la propiedad review, omita itemReviewed, porque Google trata el elemento principal como el elemento reseñado. Lo mismo vale para un aggregateRating colocado dentro de un elemento principal mediante la propiedad aggregateRating. El autor de la reseña también necesita un nombre válido de menos de 100 caracteres para un fragmento basado en el autor, así que use el nombre de la persona que escribió la reseña y no un texto promocional.

La documentación de Google también permite que una reseña independiente omita una calificación individual cuando el marcado incluye tanto un autor como una fecha de la reseña. Aun así, incluya la calificación cuando la página muestre una, para que el marcado coincida con la página.

Propiedades de reseña y su estado para Google

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

PropiedadEstado para el fragmento de reseñas de GoogleFunción en Schema.org
itemReviewedObligatoria para una reseña independiente; omítala cuando la reseña esté anidadaEl elemento que se reseña
authorObligatoria, con un nombre válido de menos de 100 caracteresLa persona que reseña
reviewRatingObligatoria, con un ratingValueUn objeto Rating que contiene la puntuación
reviewCount o ratingCountSe requiere al menos una para una calificación agregadaReseñas escritas, o todas las calificaciones
bestRating y worstRatingRecomendadasValores más alto y más bajo de la escala
datePublishedRecomendadaFecha de publicación de la reseña

Agregue el JSON-LD de reseña de producto

Este ejemplo marca una reseña de un producto. El producto, la persona que reseña y el editor son ficticios, y todas las URL usan example.com. Reemplace los valores de @id, el nombre del producto, la calificación, el nombre del autor, la fecha y el texto de la reseña por lo que aparezca en su propia página, y mantenga los valores de bestRating y worstRating acordes con la escala visible.

json
{
  "@context": "https://schema.org",
  "@type": "Review",
  "@id": "https://example.com/reviews/blue-lantern-4000-review#review",
  "name": "Buena luz en un cuerpo compacto",
  "itemReviewed": {
    "@type": "Product",
    "@id": "https://example.com/products/blue-lantern-4000#product",
    "name": "Blue Lantern 4000"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": 4,
    "bestRating": 5,
    "worstRating": 1
  },
  "author": {
    "@type": "Person",
    "name": "Jordan Lee"
  },
  "datePublished": "2026-07-20",
  "reviewBody": "La Blue Lantern 4000 ilumina lo suficiente una habitación pequeña y es fácil de llevar. La batería dura una velada, aunque el cable de carga es más corto de lo que esperaba.",
  "publisher": {
    "@type": "Organization",
    "name": "Example Review Desk"
  }
}

El título de la reseña, el texto y la puntuación en estrellas deben aparecer en la página visible, porque las directrices de Google exigen que el contenido de la reseña sea visible e inmediatamente evidente en la página marcada. Este ejemplo también está pensado para una página que pertenece a una persona que reseña o a una publicación de reseñas. No sirve para que un negocio se reseñe a sí mismo cuando el negocio controla el proceso de reseñas.

Cuando la reseña está en la propia página del producto, anídela dentro de Product y elimine itemReviewed. El bloque siguiente muestra esa estructura con una reseña más corta.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/products/blue-lantern-4000#product",
  "name": "Blue Lantern 4000",
  "review": {
    "@type": "Review",
    "name": "Fácil de llevar",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": 5,
      "bestRating": 5,
      "worstRating": 1
    },
    "author": {
      "@type": "Person",
      "name": "Sam Rivera"
    },
    "datePublished": "2026-07-22",
    "reviewBody": "Lo bastante liviana para llevarla de una habitación a otra."
  }
}

Agregue el JSON-LD de calificación agregada del producto

Este ejemplo asigna un promedio de 4.4 al mismo producto ficticio, con 89 reseñas escritas y 104 calificaciones en total en una escala de 1 a 5. Las cifras son valores de ejemplo. Cada recuento debe coincidir con lo que su página muestra a los visitantes, así que si la página dice 89 reseñas, reviewCount es 89.

json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/products/blue-lantern-4000#product",
  "name": "Blue Lantern 4000",
  "description": "Una linterna recargable ficticia para iluminación de emergencia en interiores.",
  "image": "https://example.com/images/blue-lantern-4000.jpg",
  "url": "https://example.com/products/blue-lantern-4000",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.4,
    "reviewCount": 89,
    "ratingCount": 104,
    "bestRating": 5,
    "worstRating": 1
  }
}

Aquí name es obligatorio para la función de Google, junto con aggregateRating, su ratingValue y al menos uno de los dos recuentos. Las propiedades description, image y url son opcionales para el fragmento de reseñas, aunque describen el mismo producto que muestra la página. Para la identidad del producto, el precio y la disponibilidad, siga la guía de marcado schema de producto para que la calificación quede dentro de una entidad Product completa.

Mantenga el marcado al día con la página. Cuando llegue una nueva reseña y cambie el promedio visible, actualice también ratingValue y los recuentos. Una agregación que ya no coincide con los datos de calificación visibles es una de las infracciones enumeradas en las directrices de Google. Si prefiere crear el código a partir de un formulario, el generador de schema de reseñas produce el JSON-LD por usted.

Coloque el marcado en su plataforma

Revise lo que su plataforma ya genera antes de agregar nada. Shopify indica que sus temas incluyen automáticamente datos estructurados y microdatos de producto, y que las páginas de producto pueden incluir ya información de precio, disponibilidad y reseñas, así que revise lo que genera el tema en la página de ayuda de SEO de Shopify antes de pegar una segunda descripción del mismo producto.

Squarespace indica que genera datos estructurados de forma automática, con el schema de Product entre los tipos generados, y que algunos schemas generados no pueden editarse ni eliminarse (consulte el artículo de Squarespace sobre optimización para búsqueda). Confirme qué genera una plantilla antes de agregar código de reseñas personalizado.

Webflow ofrece un campo de schema a nivel de página para JSON-LD manual, admite vincular campos de Collection (colecciones) dentro del código, recomienda el Schema Markup Validator y advierte sobre el marcado duplicado. Wix publica una guía de solución de problemas de JSON-LD sobre signos de puntuación, contenido visible de la página y sus límites para las etiquetas script.

En WordPress o en un sitio hecho a mano, agregue el JSON-LD mediante el mecanismo compatible de encabezado o de salida de página del tema o del plugin de SEO, y después valide la página ya generada. La guía de datos estructurados en WordPress explica la salida que ya generan los plugins, y la guía para agregar datos estructurados cubre las rutas generales.

Pruebe el marcado en un orden fijo

Pruebe en el orden indicado, porque cada paso responde una pregunta distinta: si el JSON es válido, si el vocabulario es válido, si una función de Google concreta acepta la página y si Google muestra algo. Primero revise la sintaxis del JSON, después use el Schema Markup Validator para el vocabulario y, por último, la Prueba de resultados enriquecidos (Rich Results Test) de Google para comprobar la elegibilidad del fragmento de reseñas. El validador de schema y el comprobador de schema de Schema Nova le ayudan con los primeros pasos.

Dos paneles simétricos con filas de estrellas y barras iguales, unidos por líneas finas y un pequeño círculo con una marca de verificación
Figura 2. El marcado y la página visible deben mostrar la misma calificación, los mismos recuentos y el mismo elemento.

Un resultado correcto no equivale a una aprobación de las políticas. Google indica que la validación de sintaxis no detecta todos los problemas de spam o de políticas de contenido, así que abra la página publicada y compárela usted mismo con el marcado: el texto de la reseña, el promedio, los recuentos, la escala y el nombre del elemento deben aparecer todos en la página. JSON-LD es un formato basado en JSON para datos vinculados, definido en la Recomendación JSON-LD 1.1 del W3C del 16 de julio de 2020, y sus reglas de sintaxis son estrictas, así que una coma sobrante impide analizar todo el bloque.

Después de publicar, revise en Search Console esa página. Google ofrece informes de Search Console sobre datos estructurados, que enumeran advertencias como campos que faltan. Cuando aparezca una, la guía para corregir advertencias de campos que faltan las revisa una propiedad a la vez.

Pasos de configuración antes de publicar el marcado de reseñas

Cada paso responde una pregunta distinta, y ninguno garantiza que algo se muestre.

  1. Confirme el elementoLa página reseña un solo elemento específico, y las reseñas no tratan sobre el negocio propio del sitio.
  2. Confirme la visibilidadEl texto de la reseña, el promedio y los recuentos son visibles para los visitantes.
  3. Elija el tipoElija Review, AggregateRating o ambos, y agregue el nombre del elemento y la escala correcta.
  4. Agregue los detallesAgregue el autor, la fecha y el recuento de reseñas o de calificaciones que muestra la página.
  5. ValideRevise la sintaxis del JSON, después el vocabulario de Schema.org y luego la Prueba de resultados enriquecidos.
  6. Publique y superviseRevise Search Console y actualice el marcado cada vez que cambien las calificaciones visibles.

Haga que el marcado de reseñas sea legible para Bing y la búsqueda con IA

Bing lee Schema.org en JSON-LD, incluidos los escenarios de reseñas y de reseñas agregadas, así que el mismo marcado le sirve (documentación de Bing sobre datos estructurados). Su herramienta URL Inspection (inspección de URL) tiene una tarjeta Markup (marcado) que muestra el JSON-LD de una página, y sus directrices para webmasters de Bing indican que el marcado debe reflejar el contenido visible. Yandex ofrece un validador de datos estructurados, y el marcado reconocido puede tardar unas dos semanas en aparecer (preguntas frecuentes sobre marcado semántico).

Para que una página sea elegible para la búsqueda de ChatGPT, permita que OAI-SearchBot la rastree (artículo de ayuda de OpenAI). Mantenga un marcado preciso y reseñas visibles en la página. Consulte si los sistemas de IA usan el marcado schema.

Corrija los problemas que impiden las estrellas de reseñas

Cuando no aparezcan estrellas después de una prueba limpia, empiece por la elegibilidad. Confirme que el tipo de elemento esté en la lista de Google, que la página trate sobre un solo elemento y que las reseñas no se refieran al propio negocio del sitio. Luego compare el marcado con la página visible, porque una discrepancia es la causa más común de un fragmento rechazado o ignorado.

Google indica que las infracciones de datos estructurados pueden dar lugar a una acción manual por datos estructurados, que elimina la elegibilidad para el resultado enriquecido afectado, pero que no quita por sí misma la página de la búsqueda web ordinaria. Entre las infracciones están el marcado de contenido que los visitantes no pueden ver, la información inexacta o engañosa, un elemento distinto del que aparece en la página, las reseñas copiadas de otro sitio, las reseñas falsas, las reseñas incentivadas no declaradas, los nombres no válidos de las personas que reseñan, una agregación que no coincide con los datos visibles, una escala que contradice la página y las reseñas de una categoría en lugar de un solo elemento.

Incluso una página que cumple todas las reglas puede no mostrar estrellas. Google indica que decide si muestra un resultado enriquecido y cuándo lo hace, y que su sistema de reseñas señala que los datos estructurados de producto pueden ayudarle a identificar reseñas de productos, pero no son la única señal. Mantenga la página precisa, rastreable e indexable, y revise la página de actualizaciones de la documentación de Google al publicar, ya que las directrices sobre reseñas han cambiado antes.

Google dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026; la guía de schema de preguntas frecuentes explica la situación de FAQPage.

Preguntas frecuentes

¿Puedo agregar schema de reseñas al sitio web de mi propio negocio?

Puede agregarlo, pero Google trata como autopromocionales las reseñas sobre su propio LocalBusiness u Organization que usted controla, y esas páginas no son elegibles para la función de estrellas de reseñas. Las reseñas de productos que usted vende son un caso distinto, y una página que reseña otros negocios sí puede ser elegible. El marcado de las reseñas de su propio negocio no cambia lo que muestra el Perfil de Empresa de Google.

¿Puedo copiar reseñas del Perfil de Empresa de Google en mi marcado?

No. Las directrices de Google no permiten reseñas ni calificaciones copiadas de otro sitio web, y tampoco se permite un promedio construido con calificaciones de otros sitios. Las calificaciones deben provenir directamente de los usuarios de su propia página.

¿Una calificación agregada necesita reseñas individuales?

Un AggregateRating necesita un ratingValue y al menos uno de reviewCount o ratingCount, así que puede describir calificaciones que no tienen reseñas escritas. Use ratingCount para el número total de calificaciones y reviewCount para las reseñas escritas, y mantenga ambos iguales a lo que ven los visitantes.

¿Necesito bestRating y worstRating?

Google los enumera como recomendados. Importan siempre que su escala no sea la predeterminada de 1 a 5, porque sin ellos una puntuación de 8 se leería contra un rango equivocado. Agregarlos a cada ejemplo deja clara la escala.

¿Por qué no aparecen estrellas si la prueba salió bien?

Una prueba aprobada solo confirma el análisis y las señales de elegibilidad documentadas. Google decide si muestra un resultado enriquecido y cuándo lo hace, y el tipo de elemento, el origen de las reseñas y el contenido visible deben cumplir sus directrices.

¿Puede una reseña de producto usar una escala de 10 puntos?

Sí. Configure bestRating en 10 y worstRating en 1, y muestre la misma escala en la página. Una puntuación visible de 8 sobre 10 con un marcado escrito para una escala de 5 puntos es una discrepancia que Google enumera como infracción.

Repaso rápido: Review o AggregateRating

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

Pregunta 1 de 3

Una página muestra la opinión escrita de un cliente y una puntuación de 4 sobre 5. ¿Qué tipo la representa?

Pregunta 2 de 3

Una página indica que 89 reseñas escritas promedian 4.4 sobre 5. ¿Qué tipo representa el resultado combinado?

Pregunta 3 de 3

Un negocio marca sus propias reseñas del Perfil de Empresa de Google incrustadas en su página principal. ¿Eso le permite obtener estrellas de reseñas de Google?

Términos del marcado de reseñas

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

Review. Una evaluación de un solo elemento.