With Shopify Online Store 2.0 themes, you can easily add and customize the Review Widget through the Shopify theme editor—no coding required. This guide walks you through the process step by step.

🎦 Learn how to install the widgets with our interactive guide

Steps to add the Review Widget on your product page

Step 1: Enable Judge.me app embed

For the Review Widget to work, the app embed needs to be enabled.

To enable Judge.me app embed:

From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Customize.
Click the App embeds icon (third one on the left panel).
Enable Judge.me app embed.
Click Save.

Step 2: Add the Review Widget block

Option 1: Add the Review Widget block using Shopify theme editor (recommended)

To install the Review Widget in Shopify theme editor:

Go to Shopify theme editor:
- From your Shopify admin, go to Online Store > Themes.
- Find the theme you want to edit and click Customize.
Find the right template:
- From the dropdown menu at the top, select Products > Default product.
Add the block:
- On the left panel, inside Template, click + Add section.
- Go to the Apps tab and select Review Widget.
- Hover over the block, hold the 6-dot icon (⋮⋮), and drag it up or down to change its position.
Click Save.

Option 2: Add the Review Widget block from Judge.me

To install the Review Widget automatically:

From your Judge.me admin, go to Widgets > Review Widget > Customize.
Click the Install button.
You’ll be redirected to the Shopify theme editor, where the Review Widget block has been added automatically in the Template on the left panel.
Hover over the block, hold the 6-dot icon (⋮⋮), and drag it up or down to change its position.
Click Save in the Shopify theme editor.

See the steps for the new app design (beta)

To automatically install the Review Widget from Judge.me:

In your Judge.me admin, go to Settings > Widgets.
Find the Review Widget card and click Install.
You’ll be redirected to the Shopify theme editor, where the widget block is added to the left panel in the Template.
Hover over the block, hold the ⋮⋮ icon, and drag it to your desired position.
Click Save in the Shopify theme editor.

Troubleshoot

"review_widget" not added. There is a problem with the app block

Issue:

After clicking the Install button from Option 2, you see a red error message in Shopify theme editor: "review_widget" not added. There is a problem with the app block. Contact the app developer.

Why it happens:

The '"review_widget" not added' error appears when Shopify is unable to add the "Review Widget" block into your theme.

How to fix:

If you run into the '"review_widget" not added' error, you can ignore the error and manually install the Review Widget in Shopify theme editor using Option 1 instead.

I see 2 Review Widget blocks

Issue:

You see multiple Review Widget sections on your product page.

How to fix:

To make sure only 1 Review Widget will show on your store, you can remove the duplicated Review Widget in Shopify theme editor.

To remove the duplicated Review Widget block:

From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Customize.
From the dropdown menu at the top, select Products > Default product.
On the left panel, inside Template, look for the duplicated Review Widget block and click the Trash can icon.
Click Save.

Review Widget shows in preview but not on live store

Issue:

After adding the Review Widget block, you can see the reviews in the Customize page of your Shopify theme editor, but not on your live store, product page, or browser.

How to fix:
While the cause for this issue is still unclear, to fix it, you can remove the current Review Widget block and use a custom liquid block instead.

To remove the current Review Widget block:

From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Customize.
From the dropdown menu at the top, select Products > Default product.
On the left panel, inside Template, look for the Review Widget block and click the Trash can icon.
Click Save.

To add the Review Widget using custom liquid block:

From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Customize.
From the dropdown menu at the top, select Products > Default product.
Click + Add section and select Custom Liquid.
Paste in the following Review Widget code:

<!-- Start of Judge.me code -->
<div style='clear:both'></div>
<div id='judgeme_product_reviews' class='jdgm-widget jdgm-review-widget' data-product-title='{{ product.title | escape }}' data-id='{{ product.id }}' data-auto-install='false'>{{ product.metafields.judgeme.widget }}
</div>
<!-- End of Judge.me code -->

Drag the block to your preferred position on the page.
Click Save.

Failed, click to try again

Issue:

During the onboarding Install the Review Widget step, after clicking the Install Review Widget button, you run into this error message: "Failed, click to try again".

Why it happens:

The "Failed, click to try again" error appears if we detect the that Review Widget block isn't added to your theme.

How to fix:

If you run into the "Failed, click to try again" error, you can:

Click the Failed, click to try again button and make sure to click Save in the Shopify theme editor screen.
If you already click Save but the issue persists:
- From the onboarding screen, click Continue.
- Then click Skip step to skip that specific step and proceed with the rest of the onboarding.
- After that, you can manually install the Review Widget in Shopify theme editor using Option 1 instead.

App embeds missing from live theme

Issue:

When going to Widgets in your Judge.me admin, you see this error message: "App embeds missing from live theme. This is required for all widgets to show correctly. Click the button below and then Save".

Why it happens:

The "App embeds missing from live theme" error appears if we detect the that the app embed hasn't been enabled in your theme.

How to fix:

If you run into the "App embeds missing from live theme" error:

If you've enabled app embed: you can safely ignore the error or click the X icon on the right to close the message.
If you have NOT enabled app embed: you can enable the app embed from your Shopify theme editor.

I want to remove the sample reviews in the Review Widget

Issue:

When adding the Review Widget block in the Shopify Theme Editor, you see the sample reviews from John Smith and are not sure if these reviews will be shown to your customers.

Why it happens:

For stores without reviews, we display 4 sample reviews with the name "John Smith" in the Review Widget in the Shopify Theme Editor to help you visualize what the widget will look like once real reviews are available.

These sample reviews are only visible in the Shopify Theme Editor and will not appear on your live store.

How to fix:

No further action needed. The sample reviews are for preview purposes only and will not be shown to your customers.

I don't see the "Write a review" button

Issue:

You have installed the Review Widget, but:

On some product pages, you see the reviews but not the Write a review button.
On other products, you don't see either the reviews or the Write a review button.

Why it happens:

The Write a review button might not show because Web reviews restriction was enabled.

When Web reviews restriction is enabled, only customers who receive the review request email can leave a review. As a result, the Write a review button will be hidden for everyone else.

How to fix:

To check if Web reviews restriction is enabled:

From your Judge.me admin, go to Manage Reviews > Moderation.
Scroll down to the Review restriction section.
Under Web reviews, check if either of the following options is selected:
- Only buyers who have received a review request email and API users
- Only buyers who have received a review request email
If one of the options is selected, it means Web reviews restriction is enabled.

If you're intentionally limiting reviews to verified buyers, no further action is needed.

If you want to make the Write a review button available for everyone, you can disable the Web reviews restriction.

See the steps for the new app design (beta)

To check if the Web reviews restriction is enabled:

From your Judge.me admin, go to Settings > Publishing and Moderation.
Scroll to the Review Restriction section.
Under Web reviews, see if either of these options is selected:
- Only buyers who have received a review request email and API users
- Only buyers who have received a review request email
If one of these is selected, the Web reviews restriction is enabled.

I change my Shopify theme and don't see the reviews anymore

Issue:

After switching to a new Shopify theme, the reviews and the Review Widget no longer appear on your product pages.

Why it happens:

When you change your theme, Shopify does not carry over the app blocks, code, and customizations from the old theme.

This means any Judge.me widgets you previously installed (like the Review Widget or Star Rating Badge) are not automatically added to the new theme.

How to fix:

To make sure the reviews and Review Widget show in your new theme, you just need to follow the steps above to reinstall the Review Widget in your new theme.

The Review Widget only shows 1 review

Issue:

When clicking on a product link from the Reviews dashboard, the product page loads with no reviews or only a single review visible. Example link:

https://www.shopdomain.com/products/product-name?judgeme_review_uuid=XXXX.

Why it happens:

This special URL format includes a judgeme_review_uuid query parameter, which is meant to highlight a specific review on the product page. When used, the Judge.me widget filters to show only that one review (for accessibility and deep linking purposes).

As a result:

The full list of reviews will not be visible unless users manually click a “Sort by” dropdown or reload the page without the UUID.
The Review Widget may appear empty or broken if that specific review is unpublished or hidden.

How to fix:

To view all reviews for the product: remove the ?judgeme_review_uuid=XXXX portion from the URL.

Example:

Initial URL: https://www.shopdomain.com/products/product-name?judgeme_review_uuid=XXXX
Change to https://www.shopdomain.com/products/product-name

This will reload the product page with the full Review Widget visible as expected.

Pagination in the Review Widget returns a 404 error

Issue:

At the bottom of the Review Widget, there's a pagination where you can go see the next page of reviews. However, when clicking the link to go to the second, third pages,..., instead of the reviews, you see a 404 error page.

Why it happens:

A 404 error when clicking the next page of the Review Widget typically happens when there's a JavaScript glitch between the theme and the Review Widget, preventing proper handling of pagination URLs.

How to fix:

To fix the 404 error when going to the next page in the Review Widget:

From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit, click the 3-dot icon (...) and select Edit code.
Find the theme.liquid file and scroll to the bottom of the file.
Above the body closing tag </body> and add the following JavaScript code and click Save:

document.addEventListener("DOMContentLoaded", function () {
  this.querySelectorAll('.jdgm-paginate__page').forEach(function (element) {
    element.outerHTML = element.outerHTML;
  });
});