Skip to main content

Adding the Review Widget on your product page

Updated yesterday

Available on the Free plan

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

To enable Judge.me app embed:

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find the theme you want to edit.

  3. Click Edit theme.

  4. In the left menu, click the App embeds icon (the third icon).

  5. Enable Judge.me app embed.

  6. Click Save on the top right.

Step 2: Add the "Review Widget" block

To install the Review Widget in Shopify theme editor:

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find the theme you want to edit.

  3. Click Edit theme.

  4. At the top of the theme editor, open the template dropdown in the middle.

  5. Select Products, then select Default product.

  6. On the left panel, inside Template, click + Add section.

  7. Open the Apps tab.

  8. Select the Review Widget block.

  9. (Optional) Hover over the block, hold the 6-dot icon (⋮⋮), and drag it up or down to change its position.

  10. Click Save on the top right.

Troubleshoot

"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

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:

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find the theme you want to edit.

  3. Click Edit theme.

  4. At the top of the theme editor, open the template dropdown in the middle.

  5. Select Products, then select Default product.

  6. On the left panel, inside Template, find the duplicated Review Widget block.

  7. Click the Trash can icon.

  8. Click Save on the top right.

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:

  1. From the onboarding screen, click Continue.

  2. Then click Skip step to skip that specific step and proceed with the rest of the onboarding.

  3. After that, you can manually install the Review Widget using the Shopify theme editor instead.

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.

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.

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.

The Review Widget is not showing

If you have enabled Judge.me app embed and installed the Review Widget block, but you don't see the Review Widget on your product page, first check if you enabled web reviews restriction.

To check your web reviews restriction setting:

  1. From your Judge.me admin, go to Settings > Publishing & moderation.

  2. Scroll down to the Review restriction section.

  3. For Web reviews, check which option is selected.

If your web reviews restriction is set to "Only buyers who have received a review request email and API users" or "Only buyers who have received a review request email", the Review Widget will be hidden on products with no review.

If you intentionally enable web reviews restriction, no further action is needed.

If you want to disable web reviews restriction, select "No restriction".

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:

  1. From your Shopify admin, go to Online Store > Themes.

  2. Find the theme you want to edit.

  3. Click the 3-dot icon (...).

  4. Select Edit code.

  5. Find the theme.liquid file.

  6. Scroll to the bottom of the file.

  7. 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;
      });
    });

  8. Click Save.

Resources

  1. Get your free trial:

    🚀 Enhance your Review Widget with Themes to achieve a more polished, professional look across your store—and many more customization options—with a 15-day free trial of Judge.me Awesome plan.

  2. Follow us on LinkedIn:

    ➡️ Stay updated on Judge.me product releases, tips, and merchant success stories — follow us on LinkedIn.

Related Articles
All Reviews Widget
Adding the Star Rating Badge and Review Widget on a featured product (2.0 themes)
Review Snippets Widget
Adding the Star Rating Badge on your product page
Adding the Review Widget in a tab on the product page
Did this answer your question?