Product reviews

An app block surface for a review app, plus a ratings summary that appears only when rating data exists on the product.

Merchant-addable
Yes
Settings
23
Block types
1
File
sections/product-reviews.liquid

Used by default on: Product , product.set , Product (stage)

Screenshots pending

Captures for Product reviews at desktop and mobile widths are generated from a live store by npm run shots. They appear here automatically once that has run.

When to use it

Product pages, once you have a review app collecting real reviews.

Setting it up

  1. Add the section to a product template.
  2. Install a review app from the Shopify App Store.
  3. Add the app's block inside this section in the theme editor.
  4. Configure the Rating summary and Empty state groups for how it behaves before reviews exist.

Where the content comes from

The review app owns all review data. The theme owns only the layout and the empty state.

Notes and cautions

  • Manifest does not collect or store reviews — that is an app's job, and a theme that did it would fail Theme Store review.
  • With no review app installed the section stays empty rather than showing fabricated ratings.

Section settings

Every setting on the section itself, in the order it appears in the theme editor. Group headings match the editor's own grouping.

Reviews come from your review app. Add the app's review block to this section. The rating summary reads the reviews metafields your app keeps updated.

Rating summary

Show rating summaryCheckbox

Shown when the product has a rating in the reviews metafields.

ID
show_summary
Default
On

Empty state

Empty state textMulti-line text

Shown when no review app block is added and the product has no rating.

ID
empty_text
Default
No reviews yet, lead the way and share your thoughts

Style

Color schemeColor scheme
ID
color_scheme
Default
scheme-1

Padding

Top paddingSlider
ID
padding_top
Default
36
Range
0px to 100px, in steps of 4px
Bottom paddingSlider
ID
padding_bottom
Default
36
Range
0px to 100px, in steps of 4px

Blocks

Blocks are added, reordered, duplicated, and removed inside the section. Each type has its own settings.

Heading heading_block max 2

HeadingText
ID
heading
Default
Reviews
Font size (desktop)Dropdown
ID
font_size_desktop
Default
Medium
  • XSd_heading-xs
  • Smalld_heading-sm
  • Mediumd_heading-base
  • Larged_heading-lg
  • XLd_heading-xl
  • 2XLd_heading-2xl
  • 3XLd_heading-3xl
  • 4XLd_heading-4xl
  • 5XLd_heading-5xl
  • 6XLd_heading-6xl
Font size (mobile)Dropdown
ID
font_size_mobile
Default
Medium
  • XSm_heading-xs
  • Smallm_heading-sm
  • Mediumm_heading-base
  • Largem_heading-lg
  • XLm_heading-xl
  • 2XLm_heading-2xl
Text opacity (%)Slider
ID
text_opacity
Default
100
Range
0 to 100, in steps of 5

Text styling

Text alignmentDropdown
ID
heading_text_alignment
Default
Left
  • Leftleft
  • Centercenter
  • Rightright
Text transformDropdown
ID
text_transform
Default
UPPERCASE
  • UPPERCASEuppercase
  • Lowercaselowercase
  • Capitalizecapitalize
Line height (em)Slider
ID
line_height
Default
1.2
Range
1 to 3, in steps of 0.1
Letter spacing (px)Slider
ID
letter_spacing
Default
2
Range
-2 to 15, in steps of 1

Text spacing

Top marginSlider
ID
margin_top
Default
20
Range
0px to 100px, in steps of 4px
Bottom marginSlider
ID
margin_bottom
Default
20
Range
0px to 100px, in steps of 4px

Text shadow styling

Enable text shadowCheckbox
ID
enable_text_shadow
Default
Off
Shadow x offset (px)Slider
ID
text_shadow_x
Default
0
Range
-10 to 10, in steps of 1
Shadow y offset (px)Slider
ID
text_shadow_y
Default
0
Range
-10 to 10, in steps of 1
Shadow blur radius (px)Slider
ID
text_shadow_blur
Default
0
Range
0 to 10, in steps of 1

Text animation

Heading animationDropdown
ID
text_animation
Default
None
  • Nonenone
  • Fade infade-in
  • Slide upslide-up
  • Slide downslide-down
  • Zoom inzoom-in

Text border styling

Enable text borderCheckbox
ID
enable_text_border
Default
Off
Text border width (px)Slider
ID
text_stroke_width
Default
1
Range
0 to 5, in steps of 0.5
Border styleDropdown
ID
border_style
Default
Solid
  • Solidsolid
  • Doubledouble
  • Dotteddotted
  • Dasheddashed

App blocks

This section accepts @app blocks, so apps you install can render inside it directly from the theme editor. Add the app's block the same way you add a theme block.