Feature
Review schema markup, generated automatically
A reviews widget that renders stars visually but skips the structured data is a missed SEO opportunity. Every Reviews Widget embed writes valid Review and AggregateRating JSON-LD into the host page — the review schema markup behind Google's star rich snippets — without a plugin or a line of hand-written code.
Last reviewed by the Reviews Widget product team.
What is review schema markup?
Review schema markup is structured data — normally JSON-LD — that labels each review's author, star rating, date and body, plus an aggregate score and review count for the thing being reviewed. Search engines read it directly from the HTML, which is how star ratings can appear in results.
Stars rendered as icons, SVGs or CSS are invisible to a crawler. Only structured data states, unambiguously, that "this page describes an item rated 4.8 out of 5 from 214 reviews". Google documents the property set under Review snippet, and schema.org defines the underlying AggregateRating vocabulary.
The properties that matter
| Property | Type | Written by the widget | Why it matters |
|---|---|---|---|
| ratingValue | AggregateRating | Yes — weighted across all connected sources | The average score search engines display |
| ratingCount / reviewCount | AggregateRating | Yes — combined across sources | Google requires a count alongside the average |
| bestRating / worstRating | AggregateRating | Yes — 5 and 1 | Defines the scale so 4.8 isn't read as 4.8/10 |
| author | Review | Yes — reviewer display name as Person | Anonymous reviews are ineligible |
| reviewRating.ratingValue | Review | Yes — per review | The individual star score |
| datePublished | Review | Yes — ISO 8601 | Signals freshness |
| reviewBody | Review | Yes — full text, untruncated in the markup | The visible review copy Google matches against |
| itemReviewed | Review / AggregateRating | Yes — LocalBusiness or Organization | Names the single entity the rating belongs to |
What the widget injects into your page
Each embed writes one JSON-LD block containing an AggregateRating for your business plus one Review object per visible review, nested under a single LocalBusiness (or Organization when you have no physical address). One widget, one review target — no competing rating objects.
- Markup matches what's visible on the page — a Google requirement, not a nice-to-have.
- Google asks publishers to point ratings at one review target per page; the widget never emits a second competing AggregateRating.
- Multi-source widgets roll Google, Trustpilot, Yelp, TripAdvisor, Facebook, Booking.com, Airbnb, Amazon, ProductReview.com.au, G2, Etsy, Capterra, App Store, Google Play, Expedia, OpenTable and eBay into a single weighted average rather than five conflicting scores.
- You can disable schema output per widget if your CMS or SEO plugin already emits its own review markup — duplicated ratings are worse than none.
When Google shows the stars — and when it doesn't
Valid markup makes a page eligible, never guaranteed. Google only generates review snippets for a documented list of item types, and it excludes self-serving reviews — reviews about your own business, published on your own site. Product, service and course pages are where stars realistically appear.
This is the part most widget vendors gloss over, so here it is plainly. Google's review snippet documentation states that reviews about an entity, placed on that entity's own site, are considered self-serving and are not eligible for the review snippet on LocalBusiness or Organization pages. Your Google Business Profile stars still show in Maps and the local pack — those come from Google's own review data, not your markup.
| Page type | Star snippet in Search? | Still worth marking up? |
|---|---|---|
| Product or service page reviewed by customers | Eligible | Yes — the primary star-snippet opportunity |
| Course, event, recipe, book, software listing | Eligible | Yes — all documented supported types |
| Your own homepage or About page (LocalBusiness) | Not eligible — self-serving | Yes — entity clarity, AI search, knowledge panels |
| Generic Organization or blog Article page | Not eligible | Only as entity data, never for stars |
So the honest promise is this: Reviews Widget makes the structured data correct, complete and consistent with what visitors see. Whether that earns a star snippet depends on the page type and Google's own judgement.
How to validate your review schema markup
Run the live URL through Google's Rich Results Test for eligibility, then the schema.org validator for vocabulary correctness. Both parse the rendered page, so test the published URL rather than a local preview — and re-test after any change to which reviews the widget displays.
- Publish the page with the embed in place and confirm the reviews render for a logged-out visitor.
- Paste the URL into the Rich Results Test and check for a detected review snippet item.
- Cross-check the vocabulary in the schema.org validator — it flags misspelled or misplaced properties Google silently ignores.
- Monitor the Review snippets report in Google Search Console for warnings once the page is indexed.
Showing a Google rating on the page itself
Rich snippets are Google's decision; what appears on your own page is entirely yours. Switch on the aggregate header and the widget shows your average score, the star row and the review count above the reviews — the plain "add a Google rating to my website" job most people are actually asking for. Prefer it sitewide? The floating star badge keeps the same rating in a corner of every page and opens a popup of the reviews when clicked, without reserving a section of the layout.
Both are configured in the same editor and ship in the same one-line embed — see layouts and styling.
Deep links, E-E-A-T and AI search
Every review card links back to the original review on Google, Trustpilot, Yelp, TripAdvisor, Facebook, Booking.com, Airbnb, Amazon, ProductReview.com.au, G2 or Etsy. That gives a human a one-click way to verify the review is real, and gives a crawler or AI answer engine a verifiable off-site corroboration — the experience and trust half of E-E-A-T. Combined with machine-readable ratings, it makes your review data far easier for an AI summary to cite accurately than stars drawn in CSS.
Approved website reviews count too
Reviews collected through the in-widget form are rendered inside the same Review and AggregateRating JSON-LD once you approve them in the dashboard — with the same moderation trail. Note the self-serving rule above still applies: on your own business pages these strengthen the entity data and on-page trust, but they don't manufacture star snippets. See how moderation works.
Sources & further reading
- Google Search Central — Review snippet (structured data) — supported types, self-serving review policy and required properties
- Google Search Central — Structured data general guidelines — content, quality and technical guidelines
- schema.org — AggregateRating — official vocabulary for ratingValue, ratingCount and reviewCount
- Google Rich Results Test — validate eligibility on a live URL