Check explainer · v1

Review snippets: the fields star ratings need

Automated

Last reviewed

A star rating in search results needs five facts to be readable: who reviewed, what score, what was reviewed, and how many ratings back it. The check grades Review and AggregateRating markup field by field.

How this check works

Every Review node needs a named author (a Person or Organization, not a bare string), a reviewRating with a ratingValue, and an itemReviewed with a name — or a parent name when the review nests inside one. Every AggregateRating node needs a ratingValue plus a ratingCount or reviewCount, and the same named target. Pages without any review markup are not judged.

What does a failure look like?

Rating plugins that emit ratingValue without a ratingCount; reviews credited to “Admin” as a bare string instead of a named entity; standalone reviews whose itemReviewed is missing; product pages carrying an aggregate score with no count behind it.

How to fix it, step by step

  1. Credit every review with a named Person or Organization author, not a string.
  2. Attach a ratingValue to each Review and, on aggregates, add the ratingCount or reviewCount that backs the score.
  3. Name what was reviewed — itemReviewed on standalone nodes, the parent product or article name on nested ones — then re-run the audit.

What does a pass or fail look like?

Good

4 Review nodes, each with a named author, a ratingValue and an itemReviewed — markup complete.

Fail

AggregateRating carries ratingValue: 4.8 with no ratingCount and no itemReviewed — the star cannot render.

Frequently asked questions

Do review stars still show in search results?

Yes, but Google narrowed eligibility in 2023: self-serving reviews on LocalBusiness and Organization pages no longer qualify, and the markup has to sit on pages where the reviewed item is real and visible. Valid fields are the entry ticket either way.

Why is a bare string author rejected?

Google’s required-properties spec wants a Person or Organization with a name — a string carries no identity for the snippet to attribute. The check grades it as a missing author.

Does a page without review markup fail?

No. Most sites do not publish rating markup, so absence is not judged. Only pages that ship Review or AggregateRating nodes are graded on their fields.

This rule is one of the checks the audit runs. Run the full site audit

Free preview; no account needed.

Visdenda check explainers · one page per published ruleReview snippets · v1