Documentation

Show customer reviews and star ratings

Show your review app's rating under the product title, a rating summary, the list of reviews and testimonials with Story Theme.

Reviews are often what wins over a hesitant customer. Story Theme shows the average rating and the number of reviews under the product title, a detailed rating summary, and nicely formatted testimonials. Collecting the reviews, on the other hand, is the job of a review app.

The rating under the product title

The Product rating block is already included on the product page that ships with the theme, above the title.

  1. Open Online Store > Themes > Edit theme, template Products > Default product.
  2. In the Product page section, expand the Group and click Product rating.
  3. Leave Source on Product: the block shows the rating saved by your review app.
  4. Choose the Style: Score only, Score and stars or Stars (default).
  5. Adjust the Text beside the rating if needed. [count] shows the number of reviews; if left empty, the text is "Based on [count] reviews".
  6. Click Save.
The "4.6/5" rating in stars and "Sur la base de 97 avis" above a product title
The "4.6/5" rating in stars and "Sur la base de 97 avis" above a product title
On the Lumyx demo store, the Stars style with the default text "Based on 1284 reviews", above the title and the price
On the Lumyx demo store, the Stars style with the default text "Based on 1284 reviews", above the title and the price

A product with no reviews yet shows nothing on the store. In the editor, the block shows a sample so you can adjust its appearance.

The rating can also appear on product cards in collections: in a product list, add the Rating sub-block to the Product Card.

The list of reviews

The theme doesn't display the detailed list of reviews itself: your app's widget handles that, with photos, sorting and the form for leaving a review.

  1. In the editor, on the Products > Default product template, click Add section below the product page (or Add block inside a section).
  2. In the apps tab or category, choose your review app's block (its name varies from app to app).
  3. Place it below the product page or next to the FAQ, then click Save.
Screenshot to take — Theme editor > Products > Default product > "Add section" open, Apps tab or category showing the block of an installed review app (e.g. Judge.me "Review Widget"); or, once added, the app section below the product page with the preview of the review list

A rating summary

The Rating summary block shows the average rating, the number of reviews and the breakdown by stars. You'll find it in the Reviews section (Reviews and trust category), Rating banner version, or as a block in any section.

  • Source: Product reads the rating from your review app; Custom lets you enter the score (Rating), the Number of reviews and the Distribution as percentages from 5 to 1 star (for example 82, 12, 4, 1, 1). With Custom, use the real figures from your app.
  • Layout: Stacked or Row.
  • Button text and Link: to send visitors to the page with all your reviews.
A rating summary: 4.8 out of 5, 4,056 reviews, and one bar per star count
A rating summary: 4.8 out of 5, 4,056 reviews, and one bar per star count
The Reviews section in its Rating banner version: the rating, the stars and the number of reviews on a single line
The Reviews section in its Rating banner version: the rating, the stars and the number of reviews on a single line

On the Softy demo store, a rating summary opens a reviews section, followed by a mosaic of testimonials with photos:

On the Softy demo store, a rating summary (4.8 out of 5 with the breakdown by stars) above a mosaic of testimonials and photos
On the Softy demo store, a rating summary (4.8 out of 5 with the breakdown by stars) above a mosaic of testimonials and photos

Nicely formatted testimonials

The Testimonials section (Reviews and trust category) highlights a few selected reviews: as a carousel, a grid, a mosaic with photos, or a single testimonial with an image. Each Testimonial contains stars, the text, the author (photo, name, a mention such as "Verified buyer") and the product purchased.

The Testimonials section as a carousel: three reviews as cards with their stars, the text, the author and the verified purchase mention
The Testimonials section as a carousel: three reviews as cards with their stars, the text, the author and the verified purchase mention
A testimonial card on the Hopla demo store: stars, heading, text, author and a link to the product purchased
A testimonial card on the Hopla demo store: stars, heading, text, author and a link to the product purchased

Testimonials can also go below the product page:

Three testimonials as cards below a product page on the Pulse demo store
Three testimonials as cards below a product page on the Pulse demo store

These testimonials are entered by hand: copy real reviews left by your customers, without rewriting them.

If you have a Trustpilot account, the Reviews section also offers a Trustpilot reviews version, with your rating and, optionally, the official TrustBox widget (Load the TrustBox widget setting, with the IDs provided by Trustpilot).

The Reviews section in its Trustpilot reviews version: the Trustpilot rating above three reviews as cards and a button to all reviews
The Reviews section in its Trustpilot reviews version: the Trustpilot rating above three reviews as cards and a button to all reviews

Star color

The theme's stars use the star color defined in the Color palette (Theme settings > Colors), coral orange by default. The Stars (typed score) block also has a Stars color setting for a one-off exception; leave it empty to follow the palette.

So the color changes from one store to another: coral orange on the Softy demo store (above), turquoise on the Lumyx demo store, golden yellow on the Hopla demo store.

Golden yellow stars at the top of a testimonial on the Hopla demo store
Golden yellow stars at the top of a testimonial on the Hopla demo store

Stars in Google results

Most review apps already add the rating information that Google can show in its results. If yours doesn't, click the Product page section and check Add the rating to search results. Don't turn it on if your app already does this: Google would see the rating twice.

Frequently asked questions

The rating doesn't show even though the product has reviews

Check that the block's Source is set to Product, then that your app syncs the rating to Shopify (an option to turn on in the app). If the rating appears in the Shopify admin but not on the store, make sure you're using the latest version of the theme (see Update the theme), then contact support with the product link.

Can I import my reviews from another store?

Importing happens in your review app, not in the theme. Most apps offer a file import.

Learn more