Google Rich Snippets
Add product rating structured data to your product pages, so Google can show star ratings in search results.
Google Rich Snippets adds each product's rating to its product page as structured data, so Google can show star ratings next to the page in search results. Google decides whether, and when, it shows them.
Navigate to Settings → Syndication → Google Rich Snippets to manage Google Rich Snippets.
How Google Rich Snippets works
Google Rich Snippets is off until you turn it on. Then Cevoid adds Product structured data with an AggregateRating to your product pages: the product's average rating, from 1 to 5, and its number of ratings, star-only ratings included. Individual reviews aren't part of it, and company reviews never add structured data.
| Platform | How the rating reaches the page |
|---|---|
| Shopify | Cevoid writes each product's rating and number of ratings to Shopify's standard product rating metafields. The Product rating block of the Cevoid: Reviews Platform app puts the stars and the structured data in the page's HTML |
| Other platforms | A Dynamic Product Rating widget, or a product page review list that shows its rating summary, adds the structured data in the shopper's browser. A developer can also render it on your server |
Google reads structured data in the page's HTML more reliably than structured data added with JavaScript.
Cevoid adds no structured data for a product with no ratings, and none from sample reviews. In the browser, it also adds none when the page already has rating structured data for the product, such as from your theme, or when more than one product shows a rating on the page, such as on a collection page.
Turn on Google Rich Snippets
Turn on Google Rich Snippets once for your workspace. On Shopify, Cevoid asks you to authorize it to write ratings to each store that has the Reviews app.
- Navigate to Settings → Syndication → Google Rich Snippets
- Enable Enable Google Rich Snippets
- Click Save changes
- Click Authorize and enable, if Authorize Shopify review aggregate ownership opens
Authorizing lets Cevoid write each product's rating and number of ratings to Shopify's standard product rating metafields, replacing the values there, such as a previous review app's. Each store is filled on its own: see Shopify storefronts. Then, on Shopify, add the Product rating block: see Add the Product rating block on Shopify.
If Cevoid pauses delivery for every workspace, the page shows Delivery temporarily paused. Your setting is kept, but Cevoid adds no structured data until delivery resumes.
Add the Product rating block on Shopify
On Shopify, the Product rating block puts the rating and its structured data in your product pages' HTML. Add exactly one to your product template. The Product reviews block never adds structured data.
- Navigate to Settings → Syndication → Google Rich Snippets and click Open theme editor next to your store under Storefronts. The Shopify theme editor opens on your product template.
- Click Add block in the product's main section
- Search for
Cevoidand select Product rating - Optional: Paste the ID of a Dynamic Product Rating widget in Widget ID (optional)
- Click Save
Without a widget ID, the block shows the rating from the metafields, such as ★ 4.8 (128 ratings). With one, the widget's stars replace it once they load. Before you authorize the store, the block shows the rating already in those metafields, such as a previous review app's, and adds no structured data. To add the block from a widget instead, see Embed review widgets.
Rich snippets on other platforms
On platforms other than Shopify, your review widgets add the structured data once Google Rich Snippets is on. Add a Dynamic Product Rating widget, or a Dynamic Product Reviews widget that shows its rating summary, to your product pages: see Embed review widgets.
The widget adds the structured data with JavaScript, so the market health check rates the page Best effort. To put the rating and structured data in the page's HTML instead, a developer can render them on your server with Cevoid's Storefront API.
Shopify storefronts
On Shopify, Storefronts on Settings → Syndication → Google Rich Snippets lists each connected store that has the Reviews app. Each store progresses on its own, and connecting a store never authorizes Cevoid to write to it.
| Status | What it means |
|---|---|
| Confirmation required | Cevoid isn't authorized to write this store's ratings yet. Click Authorize |
| Waiting | The store is queued to be filled |
| In progress | Cevoid is writing the store's ratings. Latest check shows how many products are done |
| Completed | Every product's rating is written |
| Failed | Writing the ratings failed. Click Retry |
| Ready | The store is authorized, with nothing in progress |
Restored shows when Cevoid restored its authorization after the Reviews app was reinstalled. Open theme editor opens the store's product template in the Shopify theme editor.
After authorization, Cevoid updates a product's metafields as its ratings change, and checks every store's values each hour. If another app overwrites them, the hourly check restores Cevoid's values, and the market health check shows Shopify aggregate values were overwritten.
Check your market health
Market health, on the Google Rich Snippets page, checks a sample of live product pages in each market for the rating and its structured data. It checks your pages, not Google's index. Cevoid runs it once a day while Google Rich Snippets is on, and when you click Run check.
- Navigate to Settings → Syndication → Google Rich Snippets
- Click Run check under Market health
- Click View next to a market's findings. Findings and remediation opens.
- Optional: Click Rich Results Test next to a page to test it in Google's tool
In each market, the check visits up to 3 product pages with ratings: the one with the most ratings, the most recently updated one, and one that changes every day.
| Status | What it means |
|---|---|
| Healthy | The checked pages have the rating and its structured data in their HTML |
| Best effort | The structured data is added with JavaScript only |
| Needs attention | A checked page has a finding to fix |
| Checking | The check is running |
| Not checked | The market hasn't been checked yet |
| Finding | What to do |
|---|---|
| Rendered with JavaScript only | Use the Shopify Product rating block, or render the structured data on your server |
| Product rating owner block missing | Add exactly one Product rating block to the active product template |
| Visible rating missing | Repair the Product rating block or its widget. If another source adds the structured data, show a matching rating on the page |
| Duplicate rating schema, Conflicting rating schema | Remove or turn off the other source of rating structured data. If you keep an SEO app that adds it from Shopify's standard review metafields, turn off Google Rich Snippets instead |
| Shopify aggregate values were overwritten | Turn off the other review integration. Cevoid has restored its values |
| Invalid product schema | Fix or turn off the source of the invalid structured data. Cevoid never changes your theme files |
| Schema points to another product | Remove or correct the other source, so it names this product page |
| Page could not be crawled | Make the product page public, indexable, and reachable without a login or a redirect to another domain |
| Check was inconclusive | Remove consent or login barriers for crawlers, then run the check again |
Findings show on this page and as the status of Google Rich Snippets on Settings → Syndication, such as On · Healthy or On · Needs attention. Cevoid doesn't email them.
Turn off Google Rich Snippets
Turn off Google Rich Snippets to stop Cevoid adding rating structured data to your product pages.
- Navigate to Settings → Syndication → Google Rich Snippets
- Disable Enable Google Rich Snippets
- Click Save changes
On Shopify, Cevoid keeps your stores' rating metafields up to date, so the Product rating block still shows the stars.