Glossary · AI Search & Prompting

Schema Markup for Reviews

Review schema markup describes a genuine review or aggregate rating in structured data so eligible search systems can interpret it accurately.
Back to glossary

What is schema markup for reviews?

Schema markup for reviews is structured data that identifies a review, its subject, its author, and its rating. A page may describe one Review or summarize many ratings with AggregateRating when the page and the underlying data meet the applicable search guidelines.

Marketing teams encounter review markup on product, software, book, course, recipe, and other eligible pages. The markup does not create a review and does not guarantee stars in a search result. It translates visible, genuine review information into a machine-readable format so a search engine can evaluate the page for supported presentation features.

Why schema markup for reviews matters

Review markup can make rating data less ambiguous, but its larger value is discipline. The team has to identify what is being reviewed, where the rating came from, how the scale works, and whether the page displays the same information. That protects the site from using a vague five-star claim with no review object, count, or traceable source.

Use the most specific item type available for the reviewed subject and include only ratings that the business actually collects and displays. Keep ratingValue, bestRating, worstRating, reviewCount, and the reviewed item's identity synchronized with the source system. Company-authored praise about the company itself should not be disguised as independent review evidence.

How to use schema markup for reviews in practice

Teams can make schema markup for reviews easier to maintain by treating it as a data contract. Name the object, its stable identifier, its permitted properties, and the source responsible for each value. Choose a measure that follows the actual job. Validity, coverage, reviewer effort, conversion, response time, source quality, and revenue can describe different outcomes and should stay separate. A short decision record should state the current approach, evidence, owner, date, and condition for revision. That makes schema markup for reviews useful beyond the person who first implemented it.

Example

A B2B software company publishes a page for a specific training course. The page shows an average rating of 4.6 from 84 verified learners, explains that the scale runs from one to five, and includes several written reviews. Its JSON-LD describes the Course and attaches an AggregateRating using the same 4.6 value and 84 count. When another review arrives, the page and markup update from the same database field.

If the visible page says 4.6 while the markup says 4.8, the implementation is already broken. Review schema works best as a structured reflection of maintained evidence, not as an extra promotional layer added after publishing.

Set up once

See what Surface can do for your team.

Get a walkthrough