Install the review widgets on your store

Getting Started · Updated Sep 1, 2026

Add the WiseReviews widgets to your theme so customers can see and write reviews on your storefront. This takes two steps: enable the app embed, then add the widget blocks to your theme.

Open the widget installer

  1. In WiseReviews, go to Settings.
  2. Under Install review widgets, click Open widget installer.

You can also get here from the Setup guide on the Home page by clicking Install widgets.

Each step shows an Active or Inactive badge that reads your published theme, so you can see what is already done without hunting through the theme editor. The badges refresh when you come back to the WiseReviews tab after making a change.

The Install review widget modal with Step 1 App embed and Step 2 Widget app blocks, each showing an Active or Inactive badge

Step 1: Enable the app embed

The app embed loads the widget code on your storefront. Widgets will not appear until it is enabled.

  1. In the installer, under App embed, click Enable app embed. The Shopify theme editor opens in a new tab with the WiseReviews app embed already switched on.
  2. Click Save in the theme editor.
  3. Go back to the WiseReviews tab. The badge changes to Active.

Once the step is active, the button reads Manage instead, and takes you to the same place if you want to change the app embed settings later.

Shopify theme editor with the WiseReviews app embed toggled on in the App embeds panel

Step 2: Add the widget blocks

  1. Back in the installer, under Widget app blocks, click Enable app blocks. The theme editor opens on a product page with the Product Reviews block already added. It arrives in its own section, so the reviews list gets the full width of the page instead of your product section's narrow column.
  2. Drag it where you want it, then click Save.
  3. To add more widgets, click Add block in the section where you want one, then pick a WiseReviews block under Apps:
    • Product Reviews: the full reviews list with a write-a-review form, shown on product pages.
    • Star Rating: the average rating and review count, usually placed near the product title.
    • Featured Reviews: a carousel of the reviews you marked as featured. You can add this on any page, like your home page.

This step turns Active once your published theme has a Product Reviews or Star Rating block on a product template.

The Star Rating block also works on collection pages, so shoppers see ratings while browsing.

If you use GemPages or another page builder

Shopify's theme editor often cannot add app blocks to a page-builder product template. GemPages templates are usually named something like gp-template.

Keep the WiseReviews app embed on for your published theme. Widgets will not load without it.

On a GemPages product template:

  1. Open the product template in GemPages.
  2. Add an HTML / Liquid element.
  3. Paste this, then publish:
<wise-product-reviews data-product-id="{{ product.id }}" data-default-type="product_reviews"></wise-product-reviews>

For Featured Reviews on the homepage, use the Shopify theme editor instead: Add section → Apps → Featured Reviews. Featured Reviews is a section, so pick Add section, not Add block. See Feature your best reviews.

Vintage themes without app blocks use a different path: Install widgets on older themes without app blocks.

Check your storefront

Open a product page on your live store. If you imported or collected reviews, the widgets show them right away.

The Product Reviews widget on a storefront product page, showing the rating summary, media gallery, Write a review button, and review cards

If something looks off, see Review widgets not showing on your store.

Still stuck? Message us from the chat widget and we'll help.