Technology

What Is JSON-LD Review Markup?

Structured data format using JSON-LD to describe reviews and ratings so search engines display rich snippets.

JSON-LD (JavaScript Object Notation for Linked Data) review markup is a structured data format that communicates review and rating information to search engines in a machine-readable way. It enables Google, Bing, and other search engines to display rich snippets with star ratings, review counts, and other review data directly in search results.

Basic Review Schema Example

{   "@context": "https://schema.org",   "@type": "Product",   "name": "Gradefy Review Platform",   "aggregateRating": {     "@type": "AggregateRating",     "ratingValue": "4.8",     "bestRating": "5",     "worstRating": "1",     "ratingCount": "342"   },   "review": [{     "@type": "Review",     "author": {       "@type": "Person",       "name": "Jane Smith"     },     "datePublished": "2026-01-15",     "reviewRating": {       "@type": "Rating",       "ratingValue": "5"     },     "reviewBody": "Gradefy made collecting reviews effortless."   }] }

Supported Schema Types for Reviews

  • Product — Physical or digital products with ratings
  • LocalBusiness — Local businesses with customer reviews
  • SoftwareApplication — Software and SaaS products
  • Organization — Company-level aggregate ratings
  • Course — Educational courses and programs
  • Book — Books with reader reviews

    • Implementation Best Practices

  • Use JSON-LD over microdata — Google recommends JSON-LD as the preferred format
  • Place in the head or body — JSON-LD can go anywhere in the HTML document
  • One review entity per page — Don't aggregate reviews from multiple products on one page
  • Include required fields — ratingValue and ratingCount are mandatory for AggregateRating
  • Keep data consistent — The markup must reflect the actual reviews visible on the page
  • Validate regularly — Use Google's Rich Results Test after any changes

    • Common Mistakes

  • Self-serving reviews (reviewing your own product)
  • Mismatched data between markup and visible content
  • Using review markup on pages without actual reviews
  • Marking up reviews for prohibited content types (like financial products)

    • Related Articles

    How to Collect Customer Reviews: The Complete Guide for 2026

    Customer reviews are the single most influential factor in purchase decisions. Here is everything you need to know about collecting them consistently and at scale.

    Trustpilot Pricing in 2026: What It Really Costs (And Cheaper Alternatives)

    Trustpilot is the biggest name in review platforms, but their pricing is opaque and expensive. Here is what it actually costs and what alternatives exist.

    Google Review Management: Complete Guide to Managing Google Reviews for Business

    Google reviews directly impact your local search ranking and customer trust. Here is how to actively manage them and combine them with a dedicated review platform.

    Related Terms

    Rich Snippet

    Enhanced search result listings that display additional information like star ratings, prices, or FAQs directly in Google.

    Star Rating

    A 1-to-5 scale visual rating system using star icons to represent customer satisfaction levels.

    Aggregate Rating

    A combined average rating calculated from all individual customer reviews, displayed as a single score with review count.

    SEO for Reviews

    Search engine optimization strategies specifically designed to make review content rank higher and generate organic traffic.

    All TermsStart Free Trial