Review Schema Generator: Create Review and Rating JSON-LD
Validate with Google's Rich Results Test after publishing.
FREE TOOL · NO SIGN-UP
This review schema generator creates Review JSON-LD for a product, book, course, recipe, movie, event, business or app, including the star rating, reviewer, date and review text. It is for bloggers, review sites and marketers who publish real reviews and want Google to understand them, with a chance at star ratings in search. Fill in the form and copy a ready <script type="application/ld+json"> block for your page.
The code updates as you type. The tool warns you if the rating is higher than the best possible score and reminds you that self-serving business reviews do not qualify for stars.
What Review Schema Does
Review markup uses Schema.org’s Review type to label a review on your page: what was reviewed, who reviewed it, the score and the text. Google can use it for review snippets, the star ratings and reviewer details shown under some search results.
Review vs AggregateRating
A Review is one person’s assessment, such as an editor’s review of a laptop: one author, one score, one body of text. An AggregateRating summarizes many ratings into an average with a count, such as 4.3 stars from 212 customers. Use Review when your page is an individual review. Use AggregateRating when your page shows a rating summary from many users. This generator builds a single Review. For product pages with customer averages, the Product Schema Generator includes AggregateRating fields alongside price and stock.
Supported item types
Google shows review snippets only for certain types of reviewed items. Supported types include Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Product, Recipe and SoftwareApplication. The tool’s item type menu covers the most common ones: Product, LocalBusiness, Book, Movie, Course, SoftwareApplication, Recipe, Organization, CreativeWorkSeason and Event. Pick the type that matches the thing being reviewed, not the page you publish it on.
How to Generate Review Schema
Keep the published review open while you fill in the form, so the markup matches the page exactly.
Step 1: Choose the reviewed item type
Choose the type from the menu and type the item’s name exactly as it appears in your review, such as “Sony WH-1000XM5” or “Learn Python in 30 Days”. The name ties the review to a specific item. A review of a restaurant would use LocalBusiness. A review of a cookbook would use Book.
Step 2: Enter rating and author
Enter the rating you gave, such as 4.5, and the best possible score, usually 5. The tool adds a worst rating of 1. Add the reviewer’s name, which must be a real person or organization, not “Admin” or a phrase like “50% off”. Include the review date, a short review title, the review text and your site’s name as the publisher.
Step 3: Add aggregate data if needed
If the page shows an average rating from many users rather than one review, you need AggregateRating instead. Build product ratings with the Product Schema Generator, or add an aggregateRating object with ratingValue and ratingCount to the item’s own markup. Never invent a count to make the snippet look better.
Step 4: Copy and test
Copy or download the JSON-LD and paste it into the page, for example in a Custom HTML block or your SEO plugin’s schema field. Publish, then test the live URL in Google’s Rich Results Test. Fix any errors and watch the Review snippets report in Search Console.
Google’s Review Snippet Policies
Valid code is only half the job. Google applies policies that decide whether your markup can earn stars.
Self-serving review restriction
Since 2019, Google does not show review stars for LocalBusiness and Organization markup when the business publishes reviews about itself on its own site. That includes reviews collected through widgets you embed and testimonials you add to your homepage. These are considered self-serving. The markup is not harmful, but it will not produce stars. Reviews of products you sell are treated differently and can still be eligible on product pages, provided they come from real customers.
Reviews must be visible on the page
The review in your markup must be shown on the same page, readable by users. Do not mark up a review that only exists in code, sits behind a hidden tab users cannot open, or lives on another page. Ratings and text in markup should match what visitors see. Google may take manual action for markup that misrepresents page content.
Pairing Reviews with Product Schema
Reviews of products work best when connected to full product markup.
Nesting review in Product
On a product review page, you can place the Review inside the Product’s review property, so Google sees the product’s name, brand and image together with your verdict. Alternatively, keep the Review separate with itemReviewed pointing to the product, which is what this tool generates. Either is valid. Pick one and avoid publishing two competing descriptions of the same product.
Merchant listing ratings
On pages that sell a product, ratings can appear in shopping experiences as well as normal results. Those ratings usually come from aggregated customer reviews, so use Product markup with AggregateRating and individual Review objects drawn from your review system.
Collecting Ratings That Qualify
Stars depend on real, verifiable reviews from real customers.
First-party review widgets
Review plugins for WooCommerce and Shopify collect ratings on your product pages and often output markup automatically. Check that they do not duplicate markup you add by hand, and that ratings appear visibly on the page.
Third-party review platforms
Platforms like Google Business Profile, Trustpilot and industry review sites collect reviews independently. Google may show seller ratings from these sources, but copying their reviews into your own markup is not allowed. Send customers to leave reviews with the Google Review Link Generator.
Review Markup Mistakes
These errors are the usual reasons stars never appear or get removed.
Fake or hidden ratings
Invented ratings or reviews not shown on the page break Google’s policies and can trigger a manual action.
Wrong rating scale
If you rate out of 10, set best rating to 10. A 9 without a scale reads as 9 out of 5.
Marking up testimonials as reviews
Hand-picked quotes on a sales page are testimonials, not reviews. They are self-serving and not eligible for stars.
Earn Stars the Right Way
Fill in the form above with a real, published review and copy markup that follows Google’s rules. For related markup, use the Product Schema Generator for prices and customer averages, the Recipe Schema Generator for food posts, and the Local Business Schema Generator for business details. Explore every free tool on FHSEO Hub.