Review ยท JSON-LD

Review Schema Generator

Mark up a genuine review your site hosts, with its rating, author, and the item reviewed. Read the guidance before you use this one.

One schema type at a time. Switch to graph mode to nest this with Organization, WebSite, or Breadcrumb.

Review details

Use this for a real review of a product or service you do not sell yourself. Self-serving reviews will not show stars.

YOUR DETAILS

How to use this generator

  1. Name the item being reviewed. The product, book, or service the review is about, and its type.
  2. Enter the rating given. The score and the best possible value, for example 4 out of 5.
  3. Add the reviewer and review body. Who wrote it and what they said.
  4. Copy the JSON-LD into the head of the page that shows the review.
  5. Validate with the Rich Results Test.

What is Review schema?

Review schema is structured data describing a single review of something: what was reviewed, the rating given, who wrote it, and the review text. It uses the Review type with a nested Rating.

Review markup can add star ratings to eligible results, but Google is strict about it. It must describe a genuine review of the item, shown on the page, and there are important limits on self-serving reviews.

The self-serving rule is the thing to understand

Since 2019, Google does not display self-serving review markup, meaning a business cannot mark up a review of itself and expect stars. Per Google Search Central, review markup must be for a genuine review that is visible on the page, of an item the page is about, not of the business publishing it.

So this type is right for, say, a publication reviewing a product it does not sell. It is the wrong tool for a business trying to show its own star rating; those ratings come through your Google Business Profile, not on-page Review markup. Misusing review markup is a common cause of manual actions, which is why this tool leads with a warning.

Where to put the code

Paste the generated <script type="application/ld+json"> block into the <head> of the page it describes. On WordPress, a free plugin like WPCode adds header code without editing theme files, and SEO plugins such as Yoast and Rank Math accept custom JSON-LD. On a static site, paste it straight into the HTML.

Frequently asked questions

Is this Review schema generator free?

Yes, free, browser-based, no signup.

Can I use it to show my own business's rating?

No. Self-serving reviews do not show stars and can trigger a manual action. Your business rating comes through your Google Business Profile.

When is Review markup appropriate?

When your site hosts a genuine, visible review of a product or service you do not sell yourself.

What is the difference from aggregateRating?

A Review is one review; aggregateRating summarizes many. Both must reflect real, visible reviews.

Where does it go?

In the head of the page that shows the review.