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 data that app already put there.

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 nothing to show yet.
  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.