{"id":1159,"date":"2026-05-04T16:29:15","date_gmt":"2026-05-04T15:29:15","guid":{"rendered":"https:\/\/blogs.bragly.io\/schema-markup-star-ratings-google\/"},"modified":"2026-05-04T17:27:49","modified_gmt":"2026-05-04T16:27:49","slug":"star-rating-schema","status":"publish","type":"post","link":"https:\/\/blogs.bragly.io\/star-rating-schema\/","title":{"rendered":"How to Add Schema Markup for Star Ratings in Google (2026 Guide)"},"content":{"rendered":"

Schema markup is a form of structured data \u2014 code that tells Google exactly what information lives on your page. When you add star rating schema, you are telling the search engine: “This page has a 4.7-star product with 234 reviews.” Google can then display that as rich snippets: the little gold stars you see under some search results.<\/p>\n

Key Takeaway:<\/strong> Skip the manual JSON-LD \u2014 if you are already collecting reviews from Google, Trustpilot, or any major platform, connect them to Bragly and the schema markup generates automatically. Your star ratings stay in sync with every new review, with zero ongoing maintenance.<\/p>\n

\"Google<\/figure>\n

What Is Schema Markup for Star Ratings?<\/h2>\n

Two schema types handle ratings. AggregateRating summarizes the overall rating across multiple reviews \u2014 ratingValue (the score), reviewCount (how many reviews), bestRating, and worstRating. Review schema handles individual reviews with specific author and reviewBody fields. Most businesses need AggregateRating for their product and landing pages.<\/p>\n

Why Star Ratings in Search Results Actually Matter<\/h2>\n

The numbers are hard to argue with. Pages with star ratings in Google search results see a 15\u201335% lift in click-through rate, according to research from BrightEdge and Search Engine Land. A separate study found that 88% of consumers trust user reviews as much as personal recommendations \u2014 and seeing stars in the SERP is often the first signal a potential customer gets.<\/p>\n

That trust translates directly into revenue. Products displaying 5+ reviews are 270% more likely to be purchased than those with none. Where you place those reviews on your site<\/a> matters just as much as having them \u2014 homepage hero sections, product pages, and checkout flows each convert differently.<\/p>\n

Google’s Technical Requirements for Star Rating Schema<\/h2>\n

Google has strict rules about when it will display rich snippets. Understanding these upfront saves you from debugging a non-showing schema later.<\/p>\n

Required Properties for AggregateRating<\/h3>\n
\n\n\n\n\n\n\n\n\n
Property<\/th>\nDescription<\/th>\nExample<\/th>\n<\/tr>\n<\/thead>\n
ratingValue<\/td>\nThe numeric rating<\/td>\n4.7<\/td>\n<\/tr>\n
reviewCount<\/td>\nTotal number of reviews<\/td>\n234<\/td>\n<\/tr>\n
bestRating<\/td>\nMaximum possible rating<\/td>\n5<\/td>\n<\/tr>\n
worstRating<\/td>\nMinimum possible rating<\/td>\n1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Your ratingValue must fall within the bestRating\/worstRating range. The reviewCount must be accurate \u2014 Google cross-checks it against the actual number of reviews on the page. If you claim 500 reviews but only show 12, your schema gets flagged.<\/p>\n

Google only shows rich snippets for products, recipes, movies, books, and local businesses \u2014 not for opinion pieces, news articles, or general web pages. Make sure your page type is eligible before troubleshooting a non-showing schema.<\/p>\n

How to Add Star Rating Schema Manually (Code Method)<\/h2>\n

If you are comfortable editing HTML or have a developer on call, manual implementation gives you full control. Google recommends JSON-LD format \u2014 it is cleaner and less error-prone than Microdata.<\/p>\n

Step 1: Write the JSON-LD Snippet<\/h3>\n
<script type=\"application\/ld+json\">\n{\n  \"@context\": \"https:\/\/schema.org\",\n  \"@type\": \"Product\",\n  \"name\": \"Your Product Name\",\n  \"aggregateRating\": {\n    \"@type\": \"AggregateRating\",\n    \"ratingValue\": \"4.7\",\n    \"reviewCount\": \"234\",\n    \"bestRating\": \"5\",\n    \"worstRating\": \"1\"\n  }\n}\n<\/script><\/code><\/pre>\n
\"JSON-LD<\/figure>\n
Place this inside the <head><\/code> section of your HTML page. The @type<\/code> must match your page \u2014 use Product<\/code> for product pages, LocalBusiness<\/code> for service pages, or SoftwareApplication<\/code> for SaaS.<\/p>\n
Step 2: Add Schema to Your Specific Platform<\/h3>\n
WordPress (Rank Math):<\/strong> Edit the page, open Rank Math, go to Edit Schema, and add a Product schema type. Fill in the rating fields and save.<\/p>\n
WordPress (Yoast):<\/strong> Yoast does not support rating schema natively. You will need the Yoast Schema structured data framework or a plugin like Schema Pro.<\/p>\n
Webflow:<\/strong> Add the JSON-LD in Page Settings, under the Before <\/body> tag section. Webflow does not have a native schema UI yet.<\/p>\n
Custom \/ React \/ Next.js:<\/strong> Add the script tag in your layout file’s <head><\/code>. If you are using Next.js 14 or later, use the next\/script<\/code> component with strategy=\"afterInteractive\"<\/code> to avoid blocking page load.<\/p>\n
Step 3: Validate Your Schema<\/h3>\n
Run your URL through the Google Rich Results Test<\/a>. If stars do not appear, check the Schema.dev Validator for more detailed error reporting. Common issues: ratingValue is a string instead of a number, reviewCount is missing, or the schema type does not match the page content.<\/p>\n
Add Star Ratings in 5 Minutes (No-Code Method)<\/h2>\n
If the code approach sounds like too much \u2014 or if you manage reviews across multiple platforms and want schema that stays in sync automatically \u2014 there is a faster path.<\/p>\n
Review management platforms that connect your actual review sources (Google, Trustpilot, Yelp, Facebook, and 30+ others) can generate the schema for you. Connect your accounts once, pick which ratings to display, and the platform embeds the correct JSON-LD on your site via a single script tag.<\/p>\n
Before worrying about schema, you need reviews to put in it. How to Collect More Google Reviews<\/a> covers the easiest ways to get your first batch of legitimate reviews from your happiest customers.<\/p>\n
Bragly works this way. Connect your review platforms, choose your widget style, and the embedded script includes properly formatted AggregateRating schema that matches your live review data. When new reviews come in, the schema updates automatically \u2014 no manual updates, no dev tickets.<\/p>\n
<div id=\"bragly_widget_container\" data-id=\"xxx-xxx-xxx-xxx-xxx\"><\/div>\n<script src=\"https:\/\/cdn.bragly.io\/embed.js\" defer><\/script><\/code><\/pre>\n
One thing worth knowing: the widget payload stays under 25 KB with lazy-loading, so it will not slow your pages down. The schema updates with each review sync, daily on the free plan or in real time on Business.<\/p>\n
\"Before<\/figure>\n
Manual vs. Automated: Which Is Right for You?<\/h3>\n
\n\n\n\n\n\n\n\n\n\n\n
<\/th>\nManual JSON-LD<\/th>\nBragly (Automated)<\/th>\n<\/tr>\n<\/thead>\n
Time to implement<\/td>\n30\u201360 minutes<\/td>\n5 minutes<\/td>\n<\/tr>\n
Requires developer<\/td>\nYes<\/td>\nNo<\/td>\n<\/tr>\n
Schema stays in sync<\/td>\nNo \u2014 you update it manually<\/td>\nYes \u2014 updates automatically<\/td>\n<\/tr>\n
Multi-platform reviews<\/td>\nYou build the aggregation logic<\/td>\n33+ sources connected out of the box<\/td>\n<\/tr>\n
Schema validation handled<\/td>\nYou do it yourself<\/td>\nPlatform handles it<\/td>\n<\/tr>\n
Works on<\/td>\nOne page at a time<\/td>\nAll pages with widgets<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n
How to Validate Your Star Rating Schema<\/h2>\n
Before declaring victory, validate. Two tools cover everything you need:<\/p>\n
    \n
  • Google Rich Results Test<\/a> \u2014 Enter your URL or paste your code. It tells you exactly which rich results are eligible and which are not.<\/li>\n
  • Schema.dev Validator<\/a> \u2014 More detailed than Google’s tool. Shows you every schema entity on the page, not just rich results.<\/li>\n<\/ul>\n
    Run the validation after publishing. If the page is new, Google may take a few days to index and display the stars. Use Google Search Console’s URL Inspection tool to request re-crawling after fixing schema errors.<\/p>\n
    Why Your Star Ratings Might Not Be Showing<\/h2>\n
    Even with valid schema, stars sometimes do not appear. Here is the checklist:<\/p>\n
      \n
    • Your page is new.<\/strong> Google takes time to crawl and index structured data. Wait one to two weeks after publishing before you worry.<\/li>\n
    • The schema type does not match the page.<\/strong> Rating schema on a blog post will not trigger stars \u2014 only eligible page types like products, local businesses, and recipes qualify.<\/li>\n
    • The reviews are brand new.<\/strong> Google is cautious about fresh ratings. A page that accumulated 50 reviews in a single day looks suspicious.<\/li>\n
    • There are technical errors.<\/strong> Missing required fields, malformed JSON, or duplicate schema on the same page all cause suppression.<\/li>\n
    • Manual actions or algorithmic penalties.<\/strong> Check Google Search Console. If there is a manual action against your site for structured data abuse, stars will not show until it is resolved. Managing your online reputation across all platforms<\/a> covers how to monitor and respond to these issues systematically.<\/li>\n<\/ul>\n
      Frequently Asked Questions<\/h2>\n
      What is schema markup for star ratings?<\/h3>\n
      Schema markup for star ratings is JSON-LD or Microdata code that tells Google your page contains an AggregateRating or Review. Google uses this to display rich snippets \u2014 the star icons and rating numbers \u2014 directly in search results.<\/p>\n
      Does star rating schema improve SEO?<\/h3>\n
      Star ratings do not directly affect Google’s ranking algorithm. However, the click-through rate improvement (15\u201335% in studies) means more traffic to your page, and higher CTR is an indirect ranking signal. More clicks can lead to better rankings over time.<\/p>\n
      What is the difference between Review and AggregateRating schema?<\/h3>\n
      AggregateRating gives an overall score across many reviews \u2014 ratingValue, reviewCount, bestRating, worstRating. Review schema describes individual reviews with properties like author, reviewBody, and datePublished. Use AggregateRating for product listing pages and summary displays. Use Review for individual testimonial pages.<\/p>\n
      Can I add schema markup without a plugin?<\/h3>\n
      Yes. You can add JSON-LD directly in your HTML <head><\/code> section. On WordPress without Rank Math, manually editing your theme’s header.php<\/code> file works. For Webflow and other site builders, custom code embedding sections handle it.<\/p>\n
      Why is my AggregateRating not showing in Google?<\/h3>\n
      Check Google Search Console for structured data errors. Common causes: missing reviewCount, ratingValue outside the bestRating\/worstRating range, page type not eligible for rich results, or a recent site migration that reset Google’s index. Run the URL through the Rich Results Test and fix any errors it reports.<\/p>\n
      The Bottom Line<\/h2>\n
      Star rating schema is one of the few on-page changes that can visibly move your CTR without touching your content. Whether you go the manual route (full control, more time) or the automated route (faster setup, stays in sync with live reviews), the outcome is the same: more clicks, more trust, more conversions.<\/p>\n
      If you are already collecting reviews from Google, Trustpilot, or any of the major platforms, there is little reason to hand-code schema when your review data changes every week. An automated approach keeps your structured data honest \u2014 no manual updates, no stale ratings showing in search.<\/p>\n
      Ready to add star ratings to your site?<\/strong> Start a free Bragly account<\/a>. The free plan covers up to 10 reviews and includes schema markup generation via the embed script. No credit card required.<\/p>\n