What is Review Schema Markup?
Quick Definition
Review Schema Markup is structured JSON-LD code added to a webpage that helps search engines understand ratings, reviews, and author metadata for rich result snippets.
Detailed Explanation
By annotating pages with Schema.org vocabulary (`Review`, `SoftwareApplication`, `Product`), website owners provide Google and AI search engines with structured data regarding ratings, prices, and customer feedback. Search engines can render gold star rich snippets in search engine results pages (SERPs) when guidelines are met.
What review schema markup does
Schema markup is structured data, usually written as JSON-LD, that tells search engines what a page is about in a form they can read reliably. Review markup uses the schema.org Review and AggregateRating types to describe individual reviews and the average rating of an item. When a page qualifies, Google may show star ratings and review counts beside the result, which can improve click-through rate.
Where it is allowed and where it is not
Google only uses review markup for certain kinds of items, such as products, books, software applications, recipes and some creative works. It does not show review stars for "self-serving" reviews, which means reviews of a LocalBusiness or Organization that the business controls on its own site. Marking up your own testimonials as reviews of your company is therefore unlikely to earn stars and can create a risk of a manual action if it is misleading.
Best practices
- Mark up only what visitors can actually see on the page. The reviews in the markup must appear in the content.
- Use real, user-written reviews. Never invent ratings or review counts.
- Make sure the rated item is specific, for example a named product, and that the rating value and review count are accurate.
- Do not copy reviews from other sites into your own markup.
- Validate with Google's Rich Results Test and the Schema.org validator before publishing, and recheck after template changes.
Widgets and structured data
Review widgets that load in the browser are not always readable to crawlers, so do not rely on a widget alone for SEO. Keep your strongest quotes as real text on the page, and treat the widget as the live, synced layer. Structured data helps machines understand a page, but it is no substitute for genuinely useful content.
Common mistakes to avoid
- Marking up reviews that do not appear on the page, or copying ratings from another site.
- Using a rounded or invented rating value that does not match the visible reviews.
- Adding Review markup to a homepage about your own company and expecting stars to appear.
- Forgetting to update the markup when the widget or template changes, so the data drifts out of date.
- Treating markup as a ranking trick. It describes content; it does not replace good content.
Key Takeaways
- Structured data must adhere strictly to Google Search Central guidelines to prevent manual actions.
- Self-serving aggregate ratings on your own brand’s homepage are invalid under Google’s review snippet policy; schema should instead represent specific products, software applications, or third-party verified reviews.
- JSON-LD is Google’s recommended format for structured review markup.
Practical Examples
Example #1
Adding SoftwareApplication schema with pricing offer tiers to a pricing page.
Example #2
Annotating a blog post review with Review schema including itemReviewed, reviewRating, and author metadata.
Frequently Asked Questions
Does review schema guarantee star ratings in Google search?
No. Structured data makes a page eligible for rich results, but Google algorithms decide whether to display stars based on domain trust, relevance, and policy compliance.
Why did Google stop showing stars on my homepage?
In 2019, Google updated its policy regarding "self-serving" reviews. Websites can no longer use AggregateRating markup on their own LocalBusiness or Organization homepage for reviews about themselves.
Related Concepts
Review schema markup is structured data, usually JSON-LD, that tells search engines about reviews and ratings on a page: who wrote them, the rating, and what was reviewed. It can make a page eligible for review-related rich results, subject to Google's guidelines.
Review schema in short
Review schema markup is a block of structured data, usually JSON-LD, that describes a review or an aggregate rating: the item being reviewed, the author, the rating value and the review text. Search engines read it to understand the page.
What it does and does not do
It helps Google and other engines understand reviews and may make a page eligible for rich results. It does not guarantee stars in search results, and Google decides when to show them.
Best practices
Mark up only reviews that are visible on the page. Never mark up fake or purchased reviews. Use accurate rating values and counts. Include the item reviewed and the author. Keep markup consistent with what users see. Validate with Google's Rich Results Test and the Schema Markup Validator.
Widgets and structured data
Many widgets render reviews with JavaScript. Check whether the widget outputs markup and whether it is crawlable, then decide whether to add schema yourself. For your own business, do not add AggregateRating to your Organization or LocalBusiness markup just to chase stars.
How ProofBeer helps
ProofBeer shows reviews in embeddable widgets; add structured data only where Google's rules allow and where the reviews are visible on the page.
Frequently asked questions
What is review schema markup?
Review schema markup is structured data, usually in JSON-LD, that describes a review or aggregate rating on a page, including the item reviewed, author, rating value and text. Search engines use it to understand the page and, where guidelines allow, to show review rich results in search.
What are self-serving reviews?
Self-serving reviews are reviews of your own business or organization that you collect and mark up on your own website. Google generally does not show review stars for these when the markup is on a LocalBusiness or Organization page, so adding it purely for stars can be ineffective or against the guidelines.
How do I test review schema?
Validate it with Google's Rich Results Test and the Schema Markup Validator. Confirm the reviews in the markup are visible on the page, ratings are accurate and required properties are present. Re-test after changes to your widget or theme, because scripts can alter what is rendered.
Do testimonial widgets add review schema?
It depends on the widget. Many render reviews with JavaScript and may not output structured data. Check the rendered HTML, and add markup yourself only where Google's rules permit and the reviews are visible. Do not mark up fake reviews or add rating markup solely to chase stars.
Apply Review Schema Markup to Your Business
Start collecting real customer reviews, sync Google & Facebook feedback, and embed beautiful social proof widgets today.