BYTETOOLS

How to Generate Review JSON-LD Schema Step by Step

To generate Review JSON-LD, enter the item you are reviewing and its type, set the rating value with its best and worst bounds, add the author and review text, then copy the generated script block into your page's HTML. The Review Schema Generator builds valid, cleanly formatted markup live in your browser, omitting any empty fields so the output stays tidy.

This tutorial walks through each field, explains what the values mean, and shows where to place the finished script so search engines can read it.

What Review schema does

Review structured data describes a single critique of a product, book, movie, business or other item. When it is valid and the reviews are genuine, it can make a page eligible for review snippets — the star ratings that sometimes appear beneath a search result. The markup pairs an itemReviewed (typed to match the thing) with a reviewRating that declares your score and its scale, plus the author and review body. This tool assembles all of that into a ready-to-paste JSON-LD block.

Step-by-step: building your markup

  1. Name the reviewed item and pick its type. Enter what you are reviewing and choose the closest type — Product, Book, Movie, Restaurant, LocalBusiness, Course, SoftwareApplication and more are available.
  2. Set the rating value. Enter the score you are giving, for example 4.5.
  3. Declare best and worst ratings. Set the top and bottom of your scale — bestRating 5 for a five-star scale, or 10 if you rate out of ten. This removes ambiguity.
  4. Add the author. Enter the name of the person who wrote the review.
  5. Write the review body and publisher. Add the full review text, and a publisher if the review appears on a publication.
  6. Copy the generated JSON-LD and paste it into your page.

Where to place the script and why the scale matters

Paste the generated block into the HTML of the page the review lives on — traditionally inside the <head>, though placement in the body is also read by Google. Keep the markup consistent with what visitors actually see on the page; the reviewed item, rating and text in your JSON-LD should match the visible content.

The best and worst fields deserve special attention. They define your scale so a search engine reads ratingValue correctly. The assumed default scale is 5, so if you rate out of 10 and forget to set bestRating to 10, a 7 could be misread as 7 out of 5. Declaring the scale every time keeps your rating unambiguous.

Private, client-side generation

Everything runs in your browser. Your review text and details are never uploaded — the tool builds the JSON-LD locally and empty fields are simply left out, so you get clean markup without stray null values. As a Progressive Web App it works offline once loaded, so you can prepare schema even without a connection. After pasting, validate the result in Google's Rich Results Test to confirm eligibility.

Try the Review Schema Generator — free and 100% in your browser.

FAQ

Where exactly do I paste the Review JSON-LD?

Into the HTML of the page that shows the review, commonly within the <head>. Google also reads JSON-LD placed in the body, so either works as long as it is on the correct page.

What rating value format should I use?

Enter a number that fits your declared scale, such as 4 or 4.5 on a five-point scale. Always set bestRating and worstRating so the scale is explicit rather than assumed.

Do I need the publisher field?

Only if the review is published by an organisation, like a magazine or site. It is optional, and the tool omits it from the output if you leave it blank.

How do I confirm my markup is valid?

Paste the generated code into Google's Rich Results Test or the Schema Markup Validator. They flag errors and show whether the page is eligible for review snippets.

Related free tools

Built by ByteVancer

ByteTools is a free product of ByteVancer, a software and web development studio building web apps, SaaS and custom software. If you need SEO tooling or a custom web product, explore what ByteVancer can build.