Review schema generator and checker

Generate or check review markup

The form starts with a filled-in example. Change it, and the JSON-LD and the checks below it update as you type. To check markup you already have, open Check existing markup and paste the whole <script type="application/ld+json"> tag.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Stoneware mug, ash glaze",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.5,
    "reviewCount": 2,
    "bestRating": 5,
    "worstRating": 1
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Emma"
      },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": 5,
        "bestRating": 5,
        "worstRating": 1
      },
      "datePublished": "2026-10-06",
      "reviewBody": "Arrived well packed and keeps coffee warm."
    },
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "James"
      },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": 4,
        "bestRating": 5,
        "worstRating": 1
      },
      "datePublished": "2026-10-09",
      "reviewBody": "Good mug, but the handle is a bit small for my hand."
    }
  ]
}
</script>

Which pages can get review stars

Google shows review stars only when the reviewed item is one of these types: Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Product, Recipe or SoftwareApplication.

LocalBusiness and Organization have a catch. When a business controls the reviews about itself, its pages are not eligible for stars, and that includes reviews shown through a widget. A café that marks up its own testimonials gets valid markup and no stars. A shop that marks up reviews of the products it sells, or a site that reviews other businesses, can get them.

What the checker looks for

• Required: a name for the reviewed item; an author with a name and a reviewRating with a ratingValue on each review; a ratingValue plus reviewCount or ratingCount on aggregateRating.
• Scale: every rating must sit between worstRating and bestRating, which default to 1 and 5.
• Author names: shorter than 100 characters. Plain text instead of a Person is flagged.
• Consistency: a count lower than the number of reviews listed, or an average that does not match reviews you say are all of them.
• Common slips: reviews instead of review, a count of 0, a date in the future, an upside-down scale.

The checker reads the markup only. Google also checks things no markup can show, so test the live page in the Rich Results Test after you publish.

Mark up only reviews people can see

Google's rules ask for two things the checker cannot see. The reviews you mark up must be on the page, readable by visitors. And they must be yours: do not copy ratings from Google, Trustpilot or any other site into your markup.

If your page shows reviews with the Formgong review widget, open Fill in from your Formgong reviews and paste the site's access key. The generator loads the same approved reviews the widget shows, so the average and the count in the markup match what people see.

Where to paste the script

• Plain HTML: anywhere in the page, usually just before </head>.
• WordPress: a Custom HTML block on that page, or the custom code field of your SEO plugin.
• Shopify: many themes already print Product markup. Look at the page source first. If a Product block is there, add the rating to it instead of adding a second Product.
• Webflow, Framer, Squarespace: the page's custom code setting.