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 sees your star rating as text. With schema, it understands it as a structured data point it can use in search results — potentially showing star ratings directly in the listing, which increases click-through rates significantly.

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 It Leads to Stars in Search Results

When Google reads valid review schema on a page, it may display rich results — the yellow star ratings that appear directly under a search listing before the description. These are called rich snippets.

Rich snippets do not directly affect your ranking position, but they substantially affect click-through rate. A result with stars stands out visually from plain text results. More clicks at the same rank means more traffic, and more traffic signals to Google that the result is valuable.

• Stars appear directly under the page title in search results
• Average rating and review count are visible before any click
• Results with stars consistently outperform plain listings in CTR
• Works for product pages, service pages, and local business listings

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.

For most local businesses and service pages, AggregateRating is the more useful of the two. It is what produces the "4.8 stars from 200 reviews" display in search results.

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 review schema generator lets you enter the visible rating details and outputs code you can paste into your site.

Related reading: Free review schema generator, Preview Google review widgets for your site.

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.