Reviews

The Reviews block shows reviews from your customers in checkout, with their star ratings. You can show your store’s overall rating above them, and a review about a product can show only when that product is in the cart.

Requires: Shopify Plus. Available on the Free plan. The Free plan includes one customization in total.

New Reviews blocks show in the Content app block, with your content blocks, and use the Content rules.

Made a Reviews block before?

Reviews blocks made before the Content block keep working as they are, in the Checkout Buddy (v1) app block: see blocks made before the Content block. Blocks made with the oldest editor (styles A, B and C) show as Reviews (older) in Customizations: see older Reviews blocks.

Add a Reviews block

1. In Checkout Buddy, go to Customizations → Content → Create customization → Reviews.
2. Add your reviews, and choose how they look. The Preview shows the block as checkout draws it.
3. Under Status, turn on the switch so it reads Published, and save. New blocks start as Draft.
4. In Shopify’s checkout editor, add the Content app block where the reviews should show, and save the editor. Where it shows has a link to the editor, and warns you while the app block isn’t in your live checkout.

With Block IDs empty, the block shows in every Content app block in checkout’s sections, with your other content blocks. To show it in one place only, enter its ID in that app block’s Block IDs, and list IDs in your other Content app blocks. App blocks under each item, shipping method or pickup location need its ID. See which blocks an app block shows.

Reviews

Each review has:

Setting	What it does
Rating	1 to 5 stars, in half stars
Title	Optional. Shown in bold under the stars.
Review	What the customer said. Each line starts a new paragraph.
Name	Optional. The customer’s name, like “Sarah K.”
Detail	Optional. A line under the name, like what they bought or where they’re from.
Verified buyer	Shows the Verified label with a check next to the name
Products	Optional. The review shows only when one of these products is in the cart, ahead of reviews without products.

A block holds up to 20 reviews. Use the arrows on each review to change their order.

Only use genuine reviews from real customers, in their words.

Overall rating

Turn on Show your store’s overall rating above the reviews to show a line like “★★★★★ 4.8 out of 5 from 1,284 reviews”, for example with the totals from your reviews app.

Setting	What it does
Rating	Your overall rating, from 1 to 5, like 4.8. The stars round it to the nearest half.
Number of reviews	How many reviews the rating is from
Text	The line next to the stars. {{rating}} becomes the rating and {{count}} the number of reviews, written in the customer’s language.

Look

Setting	What it does
Heading	Optional text above the reviews, like “What our customers say”
Layout	Cards: each review in its own box. List: one after another, with lines between. Carousel: one review at a time, with arrows to see the next.
Reviews shown at first	Cards and List: how many reviews show before the Show more button. 0 shows them all.
Show more button	The button’s text, like “Show more reviews”
Star color	Gold, Green or Text color
Verified label	Shown next to the name on verified reviews, like “Verified buyer”
Collapse reviews	Customers see the stars and the title, and open a review to read it
Show on	Phones and computers, Phones only or Computers only

The stars are Shopify’s own icons, so their colors come from your checkout branding.

Who sees it

Every checkout, or Only checkouts that match the rules, with the Content rules: cart amounts, items, products, tags and collections, discount codes, cart attributes, the customer, the address, delivery and payment method, language, market, date and time, and more. Amounts are in your store’s currency, and converted at Shopify’s rate for customers paying in another one.

Translations: the heading, the overall rating’s text, the labels and each review can be translated into your store’s languages under Translations. The Preview’s language picker shows them.

Things to know

• Reviews are typed in by you. The block doesn’t read reviews from a reviews app.
• A block with only product reviews shows nothing when none of those products is in the cart, unless the overall rating is on.
• Duplicating a block makes a draft copy. Deleting one removes it from checkout right away.

Blocks made before the Content block

Reviews blocks made with this editor before the Content block keep working as they are, in the Checkout Buddy (v1) app block. On Customizations, their Kind column reads Checkout · Checkout Buddy (v1) app block. Everything above applies, except:

• Placement: a Checkout Buddy (v1) app block, with the block’s ID in Fixed block ID. See add a block to checkout.
• Who sees it: Only checkouts that match conditions, with a shorter list: cart total or subtotal, number of items, products, product type or vendor in the cart, subscriptions, discount codes, cart attributes, delivery method, shipping country or province, logged in or guest, B2B or company, language, market country, and date.
• No Show on setting.

Give a block with conditions its own app block

A Checkout Buddy (v1) app block without a Fixed block ID shows a random block whose conditions pass. A Reviews block is picked before its own conditions are checked, so it can take your other blocks’ place and show nothing. Put the block’s ID in an app block of its own.

To move one to the Content app block, make a new Reviews block, publish it, add the Content app block, then turn the old one off.

Older Reviews blocks

Blocks made before Reviews keep working and keep their editor. New blocks are made with Reviews, which has a live preview, an overall rating, layouts, product reviews, conditions and stars in your checkout’s colors.

Settings

UI version chooses the style:

Style	Looks like
A (default)	Author, stars, bold title, a green verification label, and the review. Can be collapsible.
B	A quote mark, stars, the numeric rating (for example 4.5), title, review, then the author and subject.
C	Author, stars on green squares, title, the verification label, then the review.

Reviews are collapsible/expandable (style A only) hides the review text until the customer expands the review.

Each review has:

Setting	What it does
Star rating	0.5 to 5, in half-star steps. Default 5.
Star color	Yellow (default) or Green. Style A only; B uses a fixed color and C is always green.
Review title	Shown in bold.
Review content	The review itself.
Review author	The reviewer’s name.
Review subject	Optional, such as the product reviewed. Shown in style B only.
Verification label	Optional. Default “Verified Purchase”. Shown in styles A and C.

Click Add field to add more reviews.

Show one review at a time

Turn on Enable pagination on the app block in the Checkout Editor. The block then shows one review with arrows to move between them.

Things to know about older blocks

• Review text is plain text. Links, formatting, and variables aren’t supported.
• Choose a star rating of at least 0.5.