For the complete documentation index, see llms.txt. This page is also available as Markdown.

Displaying Google Reviews on Your Storefront

Once your Google reviews are syncing into your store, this article shows how to display them on your Shopper storefront — a reviews list and an overall star rating.


Overview

This is the second stage of setting up Google Reviews. Before following this article, connect your reviews first (see the related article below), so that reviews are flowing into your store's google_reviews custom type.

Displaying reviews involves three things:

  1. Making sure the google_reviews custom type exists on your store.

  2. Adding the review snippets to the pages where you want reviews shown.

  3. Adding a little styling so the stars and layout look right.

Before you start

Your store needs the google_reviews custom type, with these fields:

  • google_name

  • google_rating

  • google_text

  • google_publish_time

  • google_avg_rating

  • google_ratings_total

  • google_review_id

If this custom type is not already on your store, your Pixfizz contact can add it. The connection step in MyPixfizz also checks for it and will tell you if it is missing.

How to display a reviews list

Add the reviews widget snippet to the template or page where you want the list to appear.

  1. In your store admin, go to Website > Snippets (or the page template you want to edit).

  2. Include the reviews widget where you want the list to show:

  3. Save.

The widget loops through the published reviews and shows the reviewer name, star rating, review text, and date.

How to display an overall rating

To show a summary star rating and total review count (for example in a header or near a product), include the rating widget:

This shows your average Google rating and the total number of reviews, taken from your Google business summary.

How to style the reviews

Add styling to your store's custom CSS so the stars and layout display correctly.

  1. In your store admin, go to Website > Assets and open style/custom.css (or your theme's custom CSS).

  2. Add styling for the review stars, for example:

  3. Save.

Adjust colours and spacing to match your store's design.

How it works

  • Only reviews you have published from the MyPixfizz reviews inbox appear on the storefront. Approving a review is not the same as publishing it.

  • The reviews list and the rating summary read from the same google_reviews data on your store.

  • Because syncing is add-only, the reviews shown are the ones already published — resyncing adds new ones rather than replacing the list.

Tips

  • Start with one page. Add the reviews widget to a single page first, confirm it looks right, then add it elsewhere.

  • Nothing showing? Check that you have published at least one review from the MyPixfizz reviews inbox, not just approved it.

  • Stars look wrong? Confirm your custom CSS is loading and that the .google-stars colour is set.

  • Connect Google Reviews to Your Store

  • Editing snippets in your store

  • Adding custom CSS to your storefront


Note for the docs editor: confirm the exact snippet include paths and the custom type field list against the current Shopper setup before publishing, and add screenshots for the snippet and CSS steps.

Last updated