Product Rating — review star display

BLOCKSNIPPETPLANNED
blocks/product-rating.liquid
snippets/product-rating.liquid
Spec only This component is planned but not yet built. The interactive playground will land in a future Mock U-12 release. This page documents the component's purpose, schema surface, file structure, and dependencies so adjacent work can plan against it.

§ 01What it is.

Star-rating display sourced from product review metafields (or future review-app integration). Configurable: scale (5-star default), size (small for cards / medium for PDP / large for dedicated review section), show-count toggle, show-score-number toggle. Renders empty / half / full stars as inline SVG. Includes proper aria-label for screen readers.


§ 02When to use it.

PDP review section. Product cards on collection pages. Compare table. Anywhere the product has a meaningful aggregated rating.


§ 03Files, type, build position.

Component type

  • Block — composable child of a section or other block. Lives in blocks/, added via the theme editor.
  • Snippet — reusable Liquid partial called from other Liquid files via {% render %}. Lives in snippets/, not directly merchant-editable.

Files

blocks/product-rating.liquid snippets/product-rating.liquid

Build position

Depends on review data source (metafield or third-party). Defer until catalog has reviews.


§ 04Related components.

The components this one depends on, composes with, or pairs with. Click through to each.