Three theme-editor blocks, opt-in, no theme code, no injection: Product review stars, Product review list, and All store reviews. They ship in the AgentReady JSON theme extension (product-stars, product-reviews, site-reviews). Add them from getting started. The write-up is Three theme blocks, no theme code.
Labels and defaults below are copied from the shipping block schemas. The preview uses the same ids.
Product review stars
Product template only.
| Setting | Schema label | Options | Default |
|---|---|---|---|
accent | Star colour | Color picker | #7257e8 |
icon | Rating icon | Classic star (star), Spark (spark), Minimal dot (dot) | star |
star_size | Star size | Small, Medium, Large | medium |
show_count | Show review count | on / off | on |
link_to_reviews | Link to the review list on this page | on / off. Only turn this on after you add the Product review list block to the same page. | off |
empty_state | When this product has no approved reviews | Show nothing (hide), Show a short "no reviews yet" line (quiet) | hide |
Product review list
Product template only. Settings are grouped in the editor as Content, Style, and Behaviour.
Content
| Setting | Schema label | Options | Default |
|---|---|---|---|
heading | Heading | text | Customer reviews |
show_histogram | Show the rating breakdown | on / off | on |
show_titles | Show review titles | on / off | on |
show_dates | Show review dates | on / off | on |
show_replies | Show store replies | on / off | on |
show_badges | Show verification badges | on / off | on |
show_photos | Show review photos | on / off | on |
date_format | Date format | Aug 1, 2026 (month_day_year), 1 Aug 2026 (day_month_year), 2026-08-01 (year_month_day), Relative (3 weeks ago) (relative) | month_day_year |
empty_state | When this product has no approved reviews | Show nothing (hide), Show a short "no reviews yet" line (quiet) | hide |
Style
| Setting | Schema label | Options | Default |
|---|---|---|---|
accent | Accent colour | Color picker | #7257e8 |
icon | Rating icon | Classic star, Spark, Minimal dot | star |
appearance | Appearance | Follow theme (auto), Light, Dark | auto |
surface | Review style | Soft cards (soft), Editorial dividers (plain), Story grid (grid) | soft |
star_size | Star size | Small, Medium, Large | medium |
card_radius | Card corners | Square (none), Soft, Round | soft |
Behaviour
| Setting | Schema label | Options | Default |
|---|---|---|---|
default_sort | Default sort | Newest, Highest rated, Lowest rated, With photos | newest |
show_sort_control | Let shoppers change the sort | on / off | on |
show_filter_control | Let shoppers filter reviews | on / off | on |
verified_only | Show verified purchases only | on / off | off |
enable_load_more | Let shoppers load more reviews | on / off. Adds a Show more reviews control that calls /apps/agentready/reviews. | on |
show_write_review | Show a write-a-review link | on / off. Adds a Write a review link to the public form on this store. The form is unverified and waits in your pending queue. | on |
All store reviews
Page and index templates. Same Content and Style groups as the product list, with these differences:
| Setting | Schema label | Default / note |
|---|---|---|
heading | Heading | What customers are saying |
empty_state | When the store has no approved reviews | hide |
show_product_links | Link product reviews to their product | on |
show_write_review | Show a write-a-review link | on, but the link does not appear on all-store lists. Those lists have no product. |
Shopper sort and filter: sort and filter. The write form: write a review.
Try the same controls here. The preview is sample data.
Theme editor settings
The same controls as the live blocks
Content, style, and behaviour from the shipping Product review list schema. The preview is sample data.
Field notes collection
All-weather trail pack
Widget preset: Follow theme → light. Sample data.
What renders
The first page paints from a metafield snapshot in Liquid. Show more reviews loads later pages through a signed endpoint on the store's own domain. See Show more reviews without a script on first paint.
Stars on collection templates are not in this release.