Schema Markup for Reviews

Review and AggregateRating schema markup enables star ratings to appear directly in Google Search results — one of the most impactful rich results for click-through rates. AggregateRating summarizes overall scores across many reviews, while individual Review objects describe a single reviewer's opinion. Both types require an itemReviewed subject (a Product, Book, Recipe, etc.).

Required Properties

PropertyTypeDescription
itemReviewedrich result
ThingThe item being reviewed (e.g. Product, Book, Recipe, LocalBusiness).
reviewRatingrich result
RatingThe rating given in this review. Include ratingValue (number).
authorrich result
Person or OrganizationThe author of the review.

Recommended Properties

Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.

PropertyTypeDescription
name
stringThe title or headline of the review.
reviewBody
stringThe full text of the review.
datePublished
ISO 8601 dateThe date the review was published.
publisher
OrganizationThe publisher of the review.

Rich Result Eligibility

Rich result type: Star rating snippet in search results

Requirements: Required: itemReviewed (the thing being reviewed), reviewRating with ratingValue, and author. AggregateRating requires ratingValue and reviewCount or ratingCount.

Example valid Review JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Review",
  "itemReviewed": {
    "@type": "Product",
    "name": "Wireless Ergonomic Mouse",
    "image": "https://example.com/images/mouse.jpg"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "5",
    "bestRating": "5",
    "worstRating": "1"
  },
  "name": "Best mouse I've ever used",
  "author": {
    "@type": "Person",
    "name": "Jane Smith"
  },
  "datePublished": "2026-03-18",
  "reviewBody": "Incredibly comfortable for long work sessions. The battery life is excellent and the scroll wheel is precise."
}

Validate via API

Validate this schema against Google's requirements in one API call:

curl "https://schemacheck.dev/api/v1/validate" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonld":{"@context":"https://schema.org","@type":"Review","itemReviewed":{"@type":"Product","name":"Wireless Ergonomic Mouse","image":"https://example.com/images/mouse.jpg"},"reviewRating":{"@type":"Rating","ratingValue":"5","bestRating":"5","worstRating":"1"},"name":"Best mouse I've ever used","author":{"@type":"Person","name":"Jane Smith"},"datePublished":"2026-03-18","reviewBody":"Incredibly comfortable for long work sessions. The battery life is excellent and the scroll wheel is precise."}}'

Official Documentation

Google Structured Data: Review

Validate your Review schema now

100 free validations/month. No credit card required.