How to Add Review Schema Markup to a Website (Step-by-Step)

What Review Schema Markup Actually Is

Schema markup is structured data you add to a webpage that helps Google understand what the content means — not just what it says. Review schema specifically tells Google that a page contains a rating or review, who gave it, what it is for, and what the score was.

Without schema, Google can still read visible rating text, but it has less explicit machine-readable context. Valid schema can make an eligible page available for a review rich result, which may help the listing stand out. Google decides whether to show the enhancement.

Steps to Manually Add Review Schema to a Website

The manual process is straightforward: choose the right schema type, write the JSON-LD, place it on the page, make sure the same review content is visible to visitors, and test the result before requesting a recrawl.

Most errors happen because the schema describes ratings that are not visible on the page, uses the wrong reviewed item, or applies review markup to a business reviewing itself. Treat the markup as a structured version of what users can already see.

• Choose Review schema for one review or AggregateRating schema for an average rating across multiple reviews
• Confirm the reviewed item is eligible for Google review snippets
• Add the JSON-LD script to the page template or page head
• Show the same rating, review count, and review content visibly on the page
• Run the URL through Google Rich Results Test and fix warnings or errors
• Submit the updated URL in Search Console once the page is valid

Related reading: Free review schema generator, How AI Overviews read your review content.

When Review Stars Can Appear in Search Results

When Google reads valid review schema for an eligible item, it may display a review rich result — the rating and review information shown beneath some search listings. Valid markup makes a page eligible; it never guarantees that Google will show the enhancement.

Eligibility is the part many guides skip. Product, recipe, software app, book, course, event, and several creative-work types can qualify when they meet their type-specific requirements. A business marking up reviews about itself does not qualify for review stars on LocalBusiness or Organization pages.

• Valid markup is required but does not guarantee a rich result
• The reviewed item must be an eligible schema type
• The marked-up rating or review must be visible on the page
• Self-serving LocalBusiness and Organization reviews are ineligible

The Two Types Worth Knowing

There are two main schema types for reviews. The first is Review schema, which represents a single review from one person. The second is AggregateRating schema, which represents an average score across multiple reviews — a star rating with a review count.

Neither type is a shortcut around Google's eligibility rules. If the page represents your own local business or organization, use accurate business identity schema and visible reviews for visitors, but do not expect self-serving Review or AggregateRating markup to produce organic star snippets.

What Google Allows and What It Penalises

Google has specific rules about review schema. The rating must reflect genuine reviews from real customers. You cannot use schema to display a high rating that is not backed by actual reviews, and you cannot apply review schema to pages that do not contain a visible review section.

There is also an important self-serving review rule. If the reviewed entity is your own LocalBusiness or Organization, Google generally does not make that page eligible for review-star rich results, even if the reviews come through an embedded third-party widget. The safe approach is to use schema only where the reviewed item and page type are eligible, and to validate against Google's current Review Snippet guidelines.

• Only use schema on pages with a visible review section
• The schema rating must match what is displayed on the page
• Do not fabricate review counts or inflate scores
• Do not mark up self-serving LocalBusiness or Organization reviews expecting Google star snippets

How to Add the JSON-LD to Your Website

Review schema is usually added as a JSON-LD script tag in the HTML of the page. In most CMSs, you add it through a custom code field, SEO plugin, tag manager, or page template. Developers can place the script in the page head or body as long as it renders in the final HTML.

If you do not want to write the code manually, use a schema generator to produce the JSON-LD, then check every field before publishing. RevuKit's free generator creates aggregate-rating markup for a specific Product or SoftwareApplication and switches to identity-only markup for a self-serving LocalBusiness page.

Related reading: Free review schema generator, Preview Google review widgets for your site, Add a Google review widget to your website.

How to Test That It Is Working

After adding the schema, use Google's Rich Results Test tool to validate it. Paste your page URL and it will show whether the schema is valid and eligible for rich results. Fix any errors it flags before expecting stars to appear in search.

Rich snippets do not appear immediately after adding valid schema. Google needs to recrawl the page first, which typically takes days to a few weeks depending on how frequently your site is indexed.