Skip to content

How do I add product reviews or star ratings?

The theme does not collect or store reviews itself. Star ratings on the product grid come from a reviews app. The theme's Show product rating setting only displays rating data that the app already stored.

Set it up

  1. Install a product reviews app from the Shopify App Store (search "reviews" or "ratings"). Most write to Shopify's standard review metafields once a review is approved, so the theme can read them without extra setup.
  2. Collect a few reviews so at least one product has rating data. An app with zero reviews has no rating data for the theme to display.
  3. If the app has one, enable its app embed: Edit theme → theme settings icon → App embeds. Most review apps use this to add their own review widget to the product page, separate from the theme's star rating.
  4. Edit theme → Theme settings → Product grid → turn on Show product rating.

See Product grid for your theme: Blockshop · Maker · Emerge · Beyond.

What the theme actually reads

Star ratings on the product card come from Shopify's standard reviews.rating and reviews.rating_count product metafields, a convention most review apps populate automatically rather than something you fill in by hand. If a product has no reviews yet, or your app doesn't write to that metafield, the setting simply has nothing to display, that's expected, not a bug.

Troubleshooting

  • I turned on Show product rating and nothing appears: the product needs at least one approved review from your app. Check the app's dashboard, not the theme.
  • Ratings show on some products but not others: only reviewed products have the metafield populated. Unreviewed products stay blank until they get a review.
  • The app's own rating widget on the product page looks different from the grid: that's the app's own block or embed, styled by the app, separate from the theme's Show product rating setting.
  • I uninstalled the app and the stars didn't disappear (or a new app's stars aren't showing): metafield data written by an app isn't always cleared on uninstall. Reinstalling the same app usually restores it; a different app needs its own review history to write the metafield fresh.

Info

See Shopify's guide to extending your theme with apps for how app embeds and blocks work generally.