JSON-LD Schema for Reviews: How to Get Star Ratings in Google

What Is JSON-LD Review Schema?

JSON-LD (JavaScript Object Notation for Linked Data) is a method of embedding structured data in your web pages so that search engines can understand your content better. When it comes to reviews, JSON-LD tells Google: "This page has customer reviews with an average rating of X out of 5 based on Y reviews."

The reward? Star ratings displayed directly in Google search results — those gold stars that dramatically increase click-through rates.

The Impact of Star Ratings in Search Results

The numbers are compelling:

• Rich snippets with stars get 35% more clicks than plain results (Search Engine Land)
• Pages with review markup see 20-30% higher CTR on average
• Star ratings in product listings increase click-through by up to 150%

This is one of the highest-ROI SEO tactics available. No content creation, no link building — just structured data that takes 15 minutes to implement correctly.

Understanding the Schema Types

Google supports several schema types for review data:

Product

For physical or digital products. Supports individual reviews and aggregate ratings.

LocalBusiness

For businesses with physical locations. Displays stars in Google Maps and local search results.

SoftwareApplication

For software products and SaaS. Relevant for app stores and software comparison searches.

Organization

For company-level reviews. Less commonly displayed in search results but still valuable.

Course, Book, Recipe, Movie, etc.

Specialized types for specific content categories.

Implementing Review Schema: Step by Step

Step 1: Choose Your Schema Type

Match the schema type to your content. An e-commerce product page uses Product. A restaurant uses LocalBusiness. A SaaS landing page uses SoftwareApplication.

Step 2: Add the AggregateRating

The AggregateRating tells Google your overall review summary. Place this JSON-LD in a script tag in your page's head section or body. The structure includes the context (schema.org), the type of entity being reviewed, its name and description, and the aggregate rating with the rating value, best and worst possible ratings, and total review count.

Important: The ratingValue and reviewCount must reflect real reviews. Google penalizes fake or fabricated review data.

Step 3: Add Individual Reviews (Optional)

For richer results, you can include individual reviews alongside the aggregate rating. Each review should include the author's name, the rating value, the date published, and the review body text.

Step 4: Test Your Markup

Use these tools to validate your implementation:

• Google Rich Results Test — richresults.google.com — Tests whether your page is eligible for rich results
• Schema Markup Validator — validator.schema.org — Validates the technical correctness of your markup
• Google Search Console — Check the Enhancements report for structured data issues

Common Mistakes That Block Star Ratings

1. Self-Serving Reviews

Google does not display star ratings for reviews that a business writes about itself. Reviews must come from real customers. If Google detects that you authored your own reviews, they will be ignored.

2. Fake or Fabricated Data

Hardcoding a 4.9 rating with 500 reviews when you actually have 3 reviews is a violation of Google's guidelines. They will penalize you, not reward you.

3. Reviews on Non-Qualifying Pages

Google does not show star ratings for every page type. Home pages, about pages, and category pages typically do not qualify. Stars appear most reliably on product pages, local business pages, and recipe pages.

4. Missing Required Properties

AggregateRating requires both ratingValue and reviewCount (or ratingCount). Omitting either will invalidate the markup.

5. Incorrect nesting

The AggregateRating must be nested inside a valid parent type (Product, LocalBusiness, etc.). A standalone AggregateRating without a parent entity will be ignored.

Platform-Specific Implementation

WordPress

Use a plugin like Yoast SEO or Rank Math to add structured data. For review-specific markup, your review widget (like Gradefy) should inject the schema automatically.

Shopify

Most review apps (Judge.me, Yotpo, Loox) add Product schema with review data automatically. Verify by viewing page source and searching for "aggregateRating."

Next.js / React

Add a script tag with type "application/ld+json" and use dangerouslySetInnerHTML to inject the JSON. Generate the schema dynamically from your review data.

Static HTML

Add the JSON-LD script tag directly in your HTML head or body. Update the values when your review count or average changes.

Automating Schema with a Review Platform

Manually maintaining JSON-LD review schema is tedious. Every time a new review comes in, you need to update the ratingValue, reviewCount, and optionally add the new individual review.

This is where review platforms add value. Gradefy's Pro plan automatically injects accurate JSON-LD schema markup when its widget loads on your page. The schema stays in sync with your actual review data — no manual updates needed.

Monitoring Your Star Ratings in Search

After implementing review schema:

• Submit your page for indexing via Google Search Console
• Monitor the Enhancements report for any structured data errors
• Search for your page in an incognito window after 1-2 weeks to see if stars appear
• Track CTR changes in Search Console to measure the impact

Star ratings typically appear within 1-4 weeks of correct implementation, depending on how frequently Google crawls your site.

Key Takeaways

• JSON-LD review schema can increase your CTR by 35% or more
• Use real customer review data — never fabricate ratings
• Match the schema type to your content (Product, LocalBusiness, SoftwareApplication)
• Test with Google Rich Results Test before going live
• Automate schema updates by using a review platform that injects markup dynamically
• Monitor results in Google Search Console