Skip to content
SEO Madmanby Adam Hafez

Review and AggregateRating schema: Google's real required fields

Google's own review-snippet documentation names exact required properties and exact abuse rules. Most markup fails one of those, not from being absent.

Published: · Read time: 4 minutes

Written byAdam Hafez
Share
Plain Markdown
A row of yellow stars on a blue and pink surface

Key takeaways

  • A single Review needs author, itemReviewed with an eligible @type, and a reviewRating carrying a ratingValue, per Google's documented required-property list.
  • An AggregateRating needs itemReviewed plus at least one of ratingCount or reviewCount, and Google states explicitly that at least one of the two is required.
  • Google's guidelines make a LocalBusiness or Organization page ineligible for the star feature when the reviewed entity controls the reviews about itself on its own site.
  • Google's technical guidelines require marked-up review content to be readily visible to users on the same page, not hidden markup with no matching on-page text.
  • Google states plainly that if bestRating is omitted a 5 is assumed and if worstRating is omitted a 1 is assumed, so the default scale is 1 to 5 unless declared otherwise.

Most guidance on review schema repeats the same short list, add reviewRating, add an author, done. Google’s own review-snippet documentation is longer than that list and stricter than it, because it does not only name required properties, it also names behavior it will disqualify a page for even when every property is technically present. The gap between “markup that validates” and “markup Google will actually show a star for” is exactly where most implementations fail.

Google’s documentation splits into two eligible cases, and each has its own required set rather than one shared list.

A single Review needs author (a Person or Organization, with what Google calls a valid name shorter than 100 characters), itemReviewed when the review is not nested inside the item it reviews, and reviewRating carrying a numeric ratingValue. The itemReviewed type has to be one Google actually recognizes for this feature: its documented list names, among others, Book, Course, Event, LocalBusiness, MediaObject, Movie, Organization, Product, Recipe and SoftwareApplication. A review of anything outside that list does not qualify for the star snippet regardless of how the rest of the markup is built.

An AggregateRating without individual reviews attached needs itemReviewed, a numeric ratingValue, and, in Google’s own words, at least one of ratingCount or reviewCount. Neither one alone with the other missing satisfies the rule; the documentation is explicit that one of the two specific properties must be present, not that a count of any kind is enough.

Google’s recommended, non-required additions are datePublished on a Review, and bestRating and worstRating on either a Review’s reviewRating or an AggregateRating. Those three are worth adding but do not block eligibility on their own if a page is otherwise correctly built.

The real documented abuse and validation rules

The properties above are structural. Google separately disqualifies pages on behavior, and this is the part implementations miss because a validator that only checks property presence has nothing to say about it.

The rule with the most practical bite is the self-serving one. Google’s guidelines state that when the entity being reviewed controls the reviews about itself, a page using LocalBusiness or any other Organization type is ineligible for the star review feature, and that this applies whether the markup is direct or served through an embedded third-party widget. A business publishing testimonials about its own services on its own site, marked up as LocalBusiness reviews, is the exact shape this rule targets. It does not reach Product review markup on a retailer’s own product pages, since the rule is scoped to LocalBusiness and Organization types specifically, which is why product review widgets remain common while self-hosted business-testimonial schema does not qualify.

Separately, Google’s technical guidelines ban fake or undisclosed incentivized reviews outright, defining the category to include reviews that are not based on a genuine experience of the product or service, and reviews written in exchange for money, discounts, vouchers, or free products that do not clearly and prominently disclose that incentive. A page can satisfy every required property and still fail this rule if the reviews behind the markup were bought without disclosure.

The visibility rule closes the remaining gap: Google’s guidelines require that the review content being marked up is readily available to users from the same marked-up page, stating it must be immediately obvious to users that the page has review content. Markup describing reviews with no matching visible text on the page is a documented violation on its own, independent of whether ratingValue, author, and itemReviewed are all correctly filled in.

On the numeric scale, Google’s documentation states the default is a 5-point scale, 1 lowest to 5 highest, and that a missing bestRating is assumed to be 5 while a missing worstRating is assumed to be 1. Neither property is required, but a site using a different scale, a 10-point or a 100-point rating, has to declare both explicitly or Google will read the value against the wrong default range.

Why we care

Every one of these rules is checkable against a live page in minutes: does itemReviewed carry an eligible type, is ratingCount or reviewCount present, does the reviewed entity control the reviews on a LocalBusiness or Organization page, is the review text actually visible where the markup claims it is, and does the declared scale match bestRating/worstRating if it is not 1 to 5. None of that requires guessing at Google’s intent, all of it is stated on the documentation page itself. What Google’s own reported numbers say about how often sites actually violate these rules at scale, rather than what the rules are, is covered on this site by Google’s review-fraud enforcement scale report, which traces Google’s 2025 Maps enforcement totals separately from the rule text covered here.

The evidence

Sample
N/A, this is a documentation review, not a data study

Hypothesis: Review and AggregateRating schema markup fails Google's documented requirements in specific, checkable ways more often than it fails from being simply absent, because the requirements combine structural rules, the required properties, with behavioral rules, visible to users and not self-serving, that are easy to violate without realizing it.

Method: Reading Google's own current, official review-snippet documentation directly, verified by fetching the live page at developers.google.com rather than relying on secondhand summaries of it, and quoting or closely paraphrasing its required-property list, its eligibility guidelines, and its technical validation rules for ratingValue, bestRating and worstRating.

Findings

  • For a single Review, Google's documentation requires author (a Person or Organization with a valid name under 100 characters), itemReviewed with an eligible @type when the review is not nested inside the reviewed item, and reviewRating carrying a numeric ratingValue.
  • Eligible itemReviewed types named in Google's documentation include Book, Course, Event, LocalBusiness, MediaObject, Movie, Organization, Product, Recipe and SoftwareApplication among others; a type outside that list is not eligible for the star review feature.
  • For AggregateRating without individual reviews, Google states at least one of ratingCount or reviewCount is required alongside itemReviewed and a numeric ratingValue; ratingCount or reviewCount alone does not satisfy the other.
  • Google's guidelines make a page ineligible for the star feature when the reviewed entity controls the reviews about itself and the page uses LocalBusiness or any other Organization type, whether the markup is direct or served through an embedded third-party widget.
  • Google's technical guidelines separately ban fake or undisclosed incentivized reviews, defined to include reviews not based on a genuine experience and reviews written for money, discounts, vouchers or free products without clearly and prominently disclosing that incentive.
  • Google's guidelines require the marked-up review content to be readily available to users from the same marked-up page, stating it must be immediately obvious to users that the page has review content; markup with no matching visible text fails this rule regardless of whether the required properties are all present.
  • On the numeric scale, Google's documentation states the default is a 5-point scale where 1 is lowest and 5 is highest, and that omitting bestRating assumes 5 while omitting worstRating assumes 1, so a non-default scale must declare both explicitly.

Limitations: This piece describes Google's documented rules for review and rating markup, not how often real sites actually violate them or how consistently Google enforces the star-snippet eligibility check in practice; the enforcement-scale question for review fraud specifically, Google's own reported 2025 numbers, is covered separately on this site and is not repeated here. Google's documentation can and does change without a dated changelog entry, so a future revision could adjust the eligible itemReviewed list or the self-serving rule's exact wording after this piece was written; the quotes here reflect the live page as fetched on 2026-09-12.

Sources

  1. 1.Review snippet (Review, AggregateRating) structured data - Google Search CentralPrimary

Frequently asked questions

Does a page need both an individual Review and an AggregateRating?

No. Google's documentation treats them as two separate eligible cases. A single Review needs author, itemReviewed, and reviewRating with a ratingValue. An AggregateRating needs itemReviewed, a ratingValue, and at least one of ratingCount or reviewCount. A page can carry either or both, but each case has to satisfy its own required properties on its own.

Can a business mark up reviews of its own product on its own site?

Only within limits Google states directly. The reviewed entity controlling the reviews about itself, on a page using LocalBusiness or any Organization type, makes that page ineligible for the star feature, whether the markup is direct or served through an embedded third-party widget. Product review markup on a retailer's own product pages is the common case that is not blocked by this specific rule, since it targets LocalBusiness and Organization types.

About the author

Adam Hafez
Adam Hafez

Founder

Founder, UpgradIQ, Inc.

Adam Hafez works on technical SEO and search measurement: how pages get crawled, indexed, ranked and now quoted by answer engines. He founded UpgradIQ, which reads Google Search Console and GA4 to tie ranking movement back to the changes that caused it. He publishes what the data supports and states the limits of it.

  • Technical SEO
  • Search Console and GA4 measurement
  • Answer engine optimization
  • Structured data

The briefing

One email when something in search actually changes. No digest padding.

Subscribe