Skip to main content

Rating Block

Display product ratings and scalable characteristics with customizable icons on your storefront.

Supported Metafield Types​

Single value types:

  • rating — a single rating with scale
  • number_integer — a whole number displayed as a rating
  • number_decimal — a decimal number displayed as a rating

List types:

  • list.rating — multiple ratings, each with its own scale
  • list.number_integer — multiple whole numbers as ratings
  • list.number_decimal — multiple decimal numbers as ratings

Key Features​

Custom Icons​

Choose from built-in icon styles — star, heart, circle, thumb, or fire — or upload your own custom icon. Icons support half-fill for fractional values (e.g., 3.5 out of 5 shows three full icons and one half icon).

Placeholder Values​

Configure placeholder values for products that don't have ratings yet.

Icon and Text Customization​

Fine-tune the appearance of rating icons and accompanying text to match your theme.

Multi-Characteristic Ratings with List Types​

Using list.rating, list.number_integer, or list.number_decimal metafields unlocks multi-characteristic rating displays — perfect for showing multiple rated attributes stacked vertically.

Item Labels​

Add descriptive labels for each list item by entering comma-separated values in the Labels setting (e.g., "Durability, Comfort, Value, Style"). Each label is paired with its corresponding rating in order.

List Spacing​

Control the vertical gap between each rating row to ensure comfortable readability.

Use Cases
  • Product characteristics Show durability, comfort, breathability, and warmth ratings for clothing using list.rating
  • Comparison scores Display taste, aroma, body, and finish scores for food or beverages
  • Feature ratings Rate battery life, camera quality, performance, and build quality for electronics
  • Simple star rating Use a single rating metafield for a straightforward overall rating display