Review Schema Generator

Why You Are Here

Star ratings are the most eye-catching thing that can appear in a search result. A row of orange stars under a listing draws attention in a way that no amount of title optimisation achieves, and it signals social proof before anyone has clicked.

That is why review markup is so widely implemented, and also why it is so widely implemented incorrectly. Review schema has stricter eligibility rules than almost any other structured data type, and the most common implementation on the web is one that Google specifically excluded years ago.

The first situation is a product or service page that has collected genuine customer reviews, where the markup needs to be added correctly so the ratings become eligible.

The second is a review or comparison site publishing editorial assessments of things it does not own, which is the use case review markup was designed for.

The third, and the most common, is diagnosing why star ratings are not showing. That answer is usually the self-serving rule covered below.

What This Tool Does

The Review Schema Generator builds valid Review and AggregateRating JSON-LD.

Enter the item being reviewed, the rating value and scale, the reviewer, the review text, and any aggregate figures, and the tool assembles correctly nested Schema.org markup with the script tag included. Copy it and paste it into your page.

The Self-Serving Review Rule

This is the single most violated rule in structured data, and it explains most cases of stars not appearing.

What this looks like in practice

A plumber adds a testimonials section to their homepage, collects five-star ratings through their own form, and marks it up with LocalBusiness and AggregateRating. No stars will appear. The business is reviewing itself on its own site.

Where Review Markup Is and Is Not Eligible

Supported Types

Review and AggregateRating can be attached to these types, among others:

Property Reference

Review

AggregateRating

Example — Review Nested Inside Product

The most common correct implementation nests review data inside Product rather than standing alone.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Merino Wool Crew Neck Jumper",
  "image": "https://example.com/images/jumper.jpg",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "bestRating": "5",
    "worstRating": "1",
    "ratingCount": "214"
  },
  "review": [
    {
      "@type": "Review",
      "author": { "@type": "Person", "name": "Sarah T" },
      "datePublished": "2026-05-18",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5",
        "worstRating": "1"
      },
      "reviewBody": "Light but genuinely warm. True to size."
    }
  ]
}

Standalone Review

For a review site assessing something it does not sell:

{
  "@context": "https://schema.org",
  "@type": "Review",
  "itemReviewed": {
    "@type": "Product",
    "name": "Example Brand Merino Jumper"
  },
  "author": { "@type": "Person", "name": "Alex Morgan" },
  "publisher": {
    "@type": "Organization",
    "name": "Example Review Site"
  },
  "datePublished": "2026-06-02",
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "4",
    "bestRating": "5",
    "worstRating": "1"
  },
  "reviewBody": "Comfortable and well made, though sizing runs large."
}

Additional Rules Worth Knowing

Do not aggregate reviews from other websites

Pulling ratings from external review platforms and presenting them as your page's aggregate is a violation. The reviews must belong to your page.

Reviews must be visible on the page

Whatever you mark up must be immediately apparent to a visitor. If you supply an AggregateRating, the aggregate figure should be visible, not just the individual reviews.

Undisclosed incentivised reviews are a violation

Reviews written in exchange for money, discounts, vouchers, or free products must clearly and prominently disclose that. Undisclosed incentivisation falls under fake reviews, which does carry manual action risk.

Review a specific item, not a category

Markup must point at one identifiable thing. A rating attached to our range of jumpers rather than a specific jumper is not eligible.

Common Mistakes to Avoid

Quick Reference