Review Schema Generator: Free JSON-LD Maker

A review schema generator builds Review and AggregateRating JSON-LD for the ratings already visible on your page. Pick an item type, enter the item name, average rating and review count, and the tool returns a script block you can paste into your page head and test before publishing. It is free and needs no sign-in.

What Is Review Schema?

Review schema is structured data that describes a rating or review in a format search engines can read. It uses the schema.org vocabulary and is usually written as JSON-LD, a block of data that sits in the page code and is invisible to visitors.

Two types do most of the work. AggregateRating summarizes many reviews with an average score (ratingValue), the number of ratings behind it (reviewCount) and the scale (bestRating and worstRating). Review describes a single opinion, with an author, a rating, the review text and a date.

When Google finds valid markup that matches what people can see on the page, it may show stars beside your result. Google's Search Central documentation calls these review snippets. They are an eligibility feature, not a guarantee, so the markup only gives you a chance at them.

How to Use the Review Schema Generator

You fill in a short form, press one button and copy the result. The steps below follow the fields on the page.

1. Choose an Item Type from the list: Product, Local Business, Book, Movie, Software / App, Course, Recipe or Event.
2. Type the Item Name (required), exactly as it appears on your page, such as Sony WH-1000XM5.
3. Enter the Rating Value (required), your average score. Decimals are fine, for example 4.6.
4. Enter the Review Count (required), the whole number of ratings behind that average. Leave Best Rating empty to use a 5-point scale, or enter a different top score.
5. Optional: under Individual Review, add a Reviewer Name, a Review Body, a rating for that review and a Date Published.
6. Click Generate Schema. The code appears under Review Schema Generated. Click Copy Code, then paste the whole snippet once into your page head.

The Clear button empties every field so you can start on the next item.

What Does the Tool Put in the Code?

The generated block always contains the schema.org context, your chosen item type, the item name and an AggregateRating. The worst rating is always set to 1. The table shows how each field is used.

The individual review is added only when you fill in a reviewer name or review text. If you enter just a rating and a date, no review block is created.

Worked Example: Headphones With 128 Ratings

Say your product page shows an average of 4.6 stars from 128 customer ratings, and one featured review from a customer named John Smith. Here is what you would enter and what you would get.

• Item Type: Product
• Item Name: Sony WH-1000XM5
• Rating Value: 4.6, Review Count: 128, Best Rating: left empty
• Reviewer Name: John Smith, rating 5, a short review text, and the date it was posted

After you click Generate Schema, the code contains a Product named Sony WH-1000XM5. Its AggregateRating reads 4.6 out of 5 with a count of 128 and a worst rating of 1. A Review block follows, with John Smith as a Person author, his 5-star rating, his text and the publish date.

The numbers in the code must match the numbers on the page. If your page shows 4.6 stars and 128 ratings, the markup should say the same. A mismatch is one of the most common reasons review markup is ignored.

How Do You Read and Act on the Result?

The output is a complete script block, so the main job is to place it correctly and confirm it is valid. Treat the result as a draft until it passes a test.

Place it once, in the head

Paste the whole snippet, including the opening and closing script lines, once into the head of the page that shows the reviews. Do not paste it twice or on unrelated pages. Duplicated blocks for the same item can create conflicting data.

Test before you publish

Run the code through the schema markup validator to catch syntax errors and missing properties. Then check the live page with Google's Rich Results Test, which tells you whether the page is eligible for review snippets.

What good and poor inputs look like

• Good: a rating that matches the page, a review count that counts real submitted ratings, and an item name identical to the visible heading.
• Poor: a round 5.0 with a handful of ratings that cannot be verified, a count copied from another page, or a name that differs from the heading.
• Fix: update the fields to the figures shown on the page, then generate the code again.

Which Item Type Should You Choose?

Choose the type that describes the thing being reviewed, not the page itself. A product page uses Product, a software download page uses Software / App, and a course landing page uses Course.

Some types have extra requirements outside review markup. A recipe page usually needs ingredients and instructions as well, so pair this output with the recipe schema generator. An event page needs dates and a location, which the event schema generator covers. For a store page where price and availability matter, the product schema generator creates fuller Product data.

If you are unsure which structured data fits your page, the general schema markup generator covers more types.

Who Is This Tool For?

It suits anyone who has real ratings on a page and wants to describe them in structured data without writing JSON by hand.

• Store owners who show customer ratings on product pages and want star eligibility in results.
• Bloggers and affiliate publishers who write original, in-depth reviews of books, movies, apps or courses.
• Developers and agencies who need a quick, clean snippet to drop into a template or send to a client.
• SEO beginners learning how AggregateRating and Review fit together, since the output shows the structure clearly.

Best Practices and Common Mistakes

Accurate markup earns trust, and inaccurate markup can cost you the feature. These habits prevent most problems.

• Mark up only visible reviews. The ratings must be on the page and come from real users. Do not add markup for reviews people cannot see.
• Avoid self-serving reviews. Google's guidelines say that reviews a business writes about itself, such as on a LocalBusiness or Organization page, are not eligible for review snippets. Choose Local Business only when it is appropriate for your page.
• Keep the scale consistent. If your page shows scores out of 10, enter 10 as the Best Rating, and keep every rating at or below it.
• Use whole numbers for the count. The tool rejects zero, decimals and negative counts.
• Include a reviewer name. A single review without an author gives search engines less to work with, so add the name when you include a featured review.
• Refresh the numbers. When your average or count changes noticeably, generate new code and update the page.

Troubleshooting a warning or a surprise

• You see an Invalid rating message. The rating, or the individual review rating, is below 1 or above the Best Rating. Lower the value or raise the Best Rating.
• The tool asks for the item name. The Item Name, Rating Value and Review Count are all required. Fill in each one.
• No review block appears. Add a reviewer name or review text. A rating or date alone does not create one.
• Stars do not appear in Google. Valid code can still go unused. Confirm the reviews are visible, wait for the page to be recrawled and check the page in the Rich Results Test.

Limitations to Know About

The tool creates one aggregate rating and, optionally, one featured review per run. It does not collect reviews, check that they are genuine or confirm that the numbers match your page. Those checks are your responsibility.

Search display depends on eligibility and is never guaranteed. Google decides when to show stars, and it can remove them if the markup breaks its guidelines. For a second structured data type on the same page, such as breadcrumbs, generate it separately and combine the blocks yourself.

You can find more markup helpers in the On-Page SEO and Meta Tags category.

Add your item details above, generate the code, copy it into your page head and test it. With accurate figures that match your visible reviews, you will have clean markup ready for Google to evaluate.