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.
How 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:
Go to your Shopify theme editor:
From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Edit theme.
Click the App embeds icon (third icon on the left menu).
Enable the "Judge.me" app embed.
Click Save on the top right.
Step 2: Add the "Review Widget" block
To install the Review Widget in Shopify theme editor:
Go to your Shopify theme editor:
From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Edit theme.
Find the product template:
At the top of the Shopify theme editor, click the Home page dropdown menu in the middle.
Select Products then select Default product.
Add the Review Widget 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 on the top right.
Troubleshoot
"review_widget" not added. There is a problem with the app block
"review_widget" not added. There is a problem with the app block
If you click the Install button when going to Settings > Widgets > Star Rating Badge, you might 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.
This error means that we weren't able to automatically add the Review Widget block into your theme.
You can safely ignore this message and manually add the Review Widget block using Shopify theme editor instead.
I see 2 Review Widgets
I see 2 Review Widgets
The Review Widget might show multiple times on your product page if 2 or more Review widget blocks were added in your theme.
To make sure that only 1 Review Widget shows on your store, you can remove the duplicated Review Widget in Shopify theme editor:
From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Edit theme.
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.
Failed, click to try again
Failed, click to try again
During the onboarding Install the Review Widget step, after clicking the Install Review Widget button, you might run into this error message: "Failed, click to try again" if we detect the that Review Widget block isn't added to your theme.
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 using the Shopify theme editor instead.
App embeds missing from live theme
App embeds missing from live theme
When going to Widgets in your Judge.me admin, you might 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" if we detect the that the app embed hasn't been enabled in your theme.
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
I want to remove the sample reviews in the Review Widget
When adding the Review Widget block in the Shopify Theme Editor, if you haven't got a review yet, you might see 4 sample reviews from John Smith 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 and be shown to your customers on your live store.
I don't see the "Write a review" button
I don't see the "Write a review" button
If you have installed the Review Widget, but:
On some product pages, you see the reviews but not the Write a review button.
On other product pages, you don't see both the reviews and the Write a review button.
This might be because Web reviews restriction is 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.
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.
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.
The Review Widget only shows 1 review
The Review Widget only shows 1 review
If you see only 1 review on your product page (even though the product has more), and the other reviews start showing if you apply a different filter, first, check if the product URL looks something like this: https://www.shopdomain.com/products/product-name?judgeme_review_uuid=XXXX.
When you click a product link from the Reviews dashboard, the URL format includes a special judgeme_review_uuid query parameter, which is meant to highlight a specific review on the product page. When used, the Review 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 you 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 pending, hidden, or archived.
To view all reviews for the product, remove the ?judgeme_review_uuid=XXXX portion from the URL. For 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 all reviews showing, instead of just 1.
Pagination in the Review Widget returns a 404 error
Pagination in the Review Widget returns a 404 error
At the bottom of the Review Widget, there's a pagination where you can go see the next page of reviews. When clicking the link to go to the second, third pages,..., instead of the reviews, if you see a 404 error page, it typically happens when there's a JavaScript glitch between the theme and the Review Widget, preventing proper handling of pagination URLs.
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:document.addEventListener("DOMContentLoaded", function () {
this.querySelectorAll('.jdgm-paginate__page').forEach(function (element) {
element.outerHTML = element.outerHTML;
});
});Click Save:
Review Widget shows in preview but not on live store
Review Widget shows in preview but not on live store
If you can see the Review Widget in the Customize page of your Shopify theme editor, but not on your live store, product page, or browser, 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 Edit theme.
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.