← Back to the blog SEO · Review & rating schema

Google review stars in search: how review schema works

How Product structured data can help eligible pages show richer Google results, make review information machine-readable, and what to expect after you publish.

Example

Example Google search result that can include rating stars and a review count
Example — Google decides when rich results appear. Your result may look different.

Review schema gives search engines structured information about the rating and reviews already visible on your website.

When Google decides a page is eligible, it can use that information to show a richer search result with rating stars and a review count. That extra detail can make your result easier to notice before someone clicks.

The same JSON-LD turns key review information into machine-readable data. That can make the rating, review count and latest review easier for AI systems and other automated tools that consume structured web data to identify and interpret.

Schema doesn't guarantee a rich snippet, higher rankings or inclusion in AI-generated answers, but it gives machines clearer structured information to work with and greatly increases the chances of an eligible rich result.

This guide explains what GR Widget adds, where to place it, how to test it with Google and what to expect after you publish.

Short answer: GR Widget Business and Agency can add Product structured data containing your rating, review count and latest review. Put the widget on a relevant service or product page, keep the review content visible, test the page with Google's Rich Results Test and request indexing. Google makes the final decision on whether stars appear. The structured data is also machine-readable, which can help compatible automated systems interpret the review information more clearly.

In this guide:

  1. What review schema actually does
  2. What GR Widget adds to your page
  3. What a rich result can look like
  4. How structured review data can help search engines and AI understand the page
  5. Why schema does not guarantee stars or AI citations
  6. Why service and product pages are better than homepages
  7. How to test your page with Google
  8. What to do if Google cannot detect the schema
  9. How long changes can take
  10. Avoiding duplicate Product schema
  11. How to enable schema in GR Widget

What review schema actually does

People can look at a review widget and instantly understand the stars, score and comments. Machines need that information in a predictable format.

Review & rating schema (JSON-LD) adds a structured description of key review data to the page alongside the visible widget. Search engines can then read the rating, review count and latest review without having to infer them only from the visual layout.

Think of it as giving the visible review content a machine-readable label — without changing how the widget looks to your visitors.

What GR Widget adds to your page

On Business and Agency, GR Widget can add Product structured data (JSON-LD) containing:

That markup is designed for search engines and systems that consume structured web data. It is included with Business and Agency, with the existing legacy entitlement behaviour unchanged for accounts that already have it.

The widget still has to show the same rating and reviews to visitors. Schema describes the proof already on the page; it does not invent extra reviews or a different score.

GR Widget currently offers 10 free layouts and 17 in total on Site and above. Schema is a Business and Agency feature, not a layout setting.

What a rich result can look like

A standard search result is usually a title, URL and short description. On eligible pages, Google may also show rating stars and a review count.

Example

Standard result

Possible rich result

Example — Google decides when rich results appear. Your result may look different.

That extra detail can help your result stand out before someone clicks. Google decides when this appearance is used, and your live result may look different from any example.

Example

Example comparison of a standard search result and a possible richer result with rating stars
Example — Google decides when rich results appear. Your result may look different.

How structured review data can help search engines and AI understand the page

Search engines can use Product structured data when a page is eligible for a richer result. The same JSON-LD also gives AI systems and other automated tools that consume structured web data a cleaner, machine-readable view of the rating, review count and latest review.

That is the AI benefit: clearer machine-readable review information. Structured data improves machine readability; it does not guarantee that any specific AI service will use, cite or surface the information.

Why schema does not guarantee stars or AI citations

Schema can increase the chance of a Google rich result. It does not guarantee a rich snippet, higher rankings or inclusion in AI-generated answers.

Google makes the final decision on when rich results appear. Paying for Business does not cause Google to show stars. Enabling schema gives machines clearer structured information to work with and greatly increases the chances of an eligible rich result — that is the claim, and no more than that.

Illustration of review schema as machine-readable Product structured data alongside a visible review widget
GR Widget adds Product structured data alongside the visible widget. Google still decides whether a richer search result appears.

Why service and product pages are better than homepages

For the best chance of a rich result, add the widget to a relevant service or product page. Rich results rarely appear for homepages.

Keep the reviews visible. The rating and reviews represented by the structured data should also be visible to visitors on the page. A service page, product page or booking page is usually a better fit than a homepage hero that only shows a compact badge.

How to test your page with Google

After the widget is published on a public URL, test that URL with Google's Rich Results Test. The test should be able to detect the Product structured data.

If you have access to Google Search Console, request indexing after adding or changing schema. That asks Google to recrawl the page; it does not force a rich result to appear.

What to do if Google cannot detect the schema

If the Rich Results Test cannot see the markup:

How long changes can take

Google may recrawl and update a result within days, but changes can also take weeks or months. A passing Rich Results Test means the structured data can be detected. It is not a timer for stars appearing in search.

Avoiding duplicate Product schema

Use one Product schema on a page. If GR Widget detects an existing Product schema, it should not add another one.

GR Widget won't add a second Product schema because competing Product definitions can create conflicting structured data. Check the schema already being added by your theme, ecommerce platform or SEO plugin before making changes.

How to enable schema in GR Widget

Open your widget in the builder and go to the SEO tab. The panel is labelled SEO & Schema.

After you publish, test the live URL and request indexing if you use Search Console.

A Google reviews widget still does the on-page job first: it shows your genuine rating and reviews where visitors decide whether to call, book or buy. Schema is the machine-readable version of that same proof. For placement that converts, see our guide on how many Google reviews customers read before booking, or browse live examples on our widget examples page.

Make reviews machine-readable

Add review & rating schema to your widget

GR Widget Business and Agency can add Product structured data with your rating, review count and latest review. It doesn't guarantee a rich snippet, but it greatly increases the chances — and gives machines clearer structured information to work with.

Build a free widget Free forever. No payment details. Shows up to 10 reviews.

No charge for 7 days. Cancel before then to avoid the first payment of $5.99/month for Site or $14.99/month for Business.