Product Card Ratings

Shows compact rating summaries on product cards (for example in collection grids).

When to use

Use this app block to improve product discovery and help shoppers compare items faster.

Required setup

This app block requires both:

1. The Product Card Ratings app embed enabled in Theme Editor.
2. A small snippet in your product card template (and predictive search results, if you use them).

Without the snippet, nothing will render on cards.

Snippet to add in product cards

Add this inside your product-card loop where card_product is available:

<fo-product-card-rating product-id="{{ card_product.id }}" rating-value="{{ card_product.metafields['app--324569563137'].rating.value.rating }}" rating-count="{{ card_product.metafields['app--324569563137'].rating_count.value }}"></fo-product-card-rating>

Also add the same snippet in predictive search result markup if you want ratings there.

Where to place the snippet

• Place it near the product title/price area in card markup.
• Keep it inside the loop for each product card.
• If your theme has multiple card variants, add it to each relevant template/snippet.
• Use card_product (or equivalent product object used by that card).

Verify your integration

1. Enable the app embed and save theme changes.
2. Open a collection page with products that have reviews.
3. Confirm rating appears on cards.
4. If not visible:
   • check <fo-product-card-rating> exists in the rendered card HTML,
   • verify product-id is the real product ID,
   • confirm review metafields exist for those products.

What you can customize

• Star and text styling
• Compact display format
• Behavior when there are no reviews

Quick links

Open app blocks page in app
Open theme editor app embeds
Demo store - collections page (password: demo)

Troubleshooting

• Snippet added outside the product loop.
• Wrong product variable (for example product instead of the card variable).
• Theme cache/preview mismatch after saving.
• Expecting output on products without rating data while hide-empty behavior is enabled.