This feature is currently in beta testing
The new Review Widget gives you finer control over how reviews appear on your product pages. Configure the header, review content layout, color palette, pagination, and more—all from a single screen. These options help you present social proof clearly, reinforce your brand, and improve conversion.
Considerations
This new version is being rolled out gradually and are not available to all stores yet.
Stores that installed Judge.me before December 9, 2025 can upgrade to the new Review Widget using the in-app upgrade banner.
Stores that installed Judge.me after December 9, 2025 may already have the new widget automatically, as the rollout continues.
The Sidebar header theme is only compatible with the Standard review section theme.
This new version will not be available for the time being, if:
Multi-language sorting is enabled.
Product pages are built using a third-party page builder.
Upgrade to the new version
Please consider these before upgrading to the Review Widget (beta version):
If you've added your own custom CSS in the old Review Widget settings, those styles won't carry over automatically. The new widget uses an updated design, so you will need to reapply or adjust your custom code after upgrading.
If your store uses custom CSS in your theme to style the old Review Widget, you may need to update the CSS selectors or class names to match the new widget's structure.
The old widget configuration is retained for 14 days after upgrading, allowing you to revert quickly (approx. 2–3 minutes). Similarly, when reverting to the old widget, the new widget version is kept for 14 days, enabling fast re-enabling if you decide to upgrade again.
Before upgrading:
Take screenshots of your current widget customizations.
Copy any custom CSS from the old widget (you can re-apply or adapt it after upgrading).
To upgrade your Review Widget to the new beta version:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Click the Upgrade now button.
A confirmation popup will appear, click Upgrade Widget to confirm.
Once you confirm, the upgrade will start automatically.
Your widgets will stay visible during the process, there's no downtime.
Our app will gradually update each product, keeping the old widget visible until the new one is ready.
The upgrade usually finishes in about 15 minutes for 500 products.
Customize Review Widget with built-in settings
As you personalize the Review Widget, you'll see real-time updates so you know exactly how it looks and behaves before publishing.
Preview it using sample reviews, real reviews, or see how it appears with no reviews at all. You can also switch between desktop and mobile views to ensure a perfect fit on every device.
1. Header theme
To choose your Review Widget theme, go to the Review Widget header settings:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Open the Theme dropdown.
Select one of the following header themes:
Standard:
Minimal:
Sidebar:
Click Save.
2. Title
To customize the title of the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
To display a title (for example, "Customer Reviews") at the top of the Review Widget, click the checkbox next to "Show widget title".
To adjust the size of this title, open the Header text size dropdown and select one of the following options:
"Small"
"Medium"
"Large" .
To set how thick or bold this title appears, open the Header text weight dropdown and select one of the following options:
"Regular"
"Bold"
Click Save.
3. Average rating
To customize how the average rating appears below the Review Widget title:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Open the Average rating style dropdown.
Select one of the following options:
"Minimal":
Shows the star icons, average rating, and review count.
Example: ★★★★★ 5.0 (3 Reviews)
"Compact":
Shows the average rating and review count.
Example: 5.0 3 Reviews
"Bold":
Shows the star icon and the average rating in bold, and review count.
Example: ★ 5.0 3 Reviews
"Extra bold":
Shows the star icon and the average rating in extra-large font size, and review count.
Example: 5.0 3 Reviews
"Stars only":
Shows the star icons in large font size, and the average rating and review count.
Example: 5.0 3 Reviews
Click Save.
4. Bar chart
By default, we display the rating filter in the header of the Review Widget.
This section—also known as the rating breakdown, star distribution, or rating summary bars—shows how many reviews each star rating has received (e.g. 5 stars, 4 stars, etc.).
It also allows customers to filter the reviews by star rating with a single click.
To customize the rating filter in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Scroll down to Bar chart.
To show the rating filter in the Review Widget, click the check boxnext to "Show bar chart".
To choose how the rating filter is displayed, open the Bar chart type dropdown and select one of the following options:
"Numbers": Shows each rating level (1–5) with the rating number next to a single star icon, a progress bar, and the number of reviews.
"Stars": Shows each rating level (1–5) as full star rows, progress bar, and the number of reviews.
To choose how the progress bars in the rating filter are displayed, open the Bar chart style dropdown and select one of the following options:
"Standard": Shows regular, thin progress bars for each rating level.
"Bold": Shows thicker progress bars for a more prominent visual effect.
Click Save.
5. Media gallery
Available on the Free plan
The media gallery is a section displayed in the middle of the Review Widget header, showcasing customer-uploaded photos and videos.
To enable the media gallery in your Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Scroll down to find and click the checkbox next to "Show media gallery".
(Optional) To display larger media thumbnails whenever the product has at least 3 images or videos, click the checkbox next to "Show expanded media gallery".
Click Save.
Note:
Currently, it’s not possible to select which images appear in the Media Gallery. The gallery automatically displays all images and videos from your published reviews.
6. Search bar
To allow customers to search for reviews in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Scroll down to find and click the check box next to "Show search bar".
Click Save.
Note:
The search bar in the Review Widget only searches reviews for the product currently being viewed. It doesn't return results from reviews grouped across other products.
7. Keyword search
Available on the Awesome plan
Let your customers search reviews more easily by highlighting the most common keywords found in published reviews.
How keyword search works:
When a product has more than 10 verified reviews, we’ll automatically generate a list of the most commonly used words and phrases from published reviews.
Only reviews written in English and reviews collected directly through Judge.me are included.
Imported reviews and reviews synced via product groups or cross-shop sync are not used for keyword generation.
Up to 10 keywords will appear as clickable buttons at the top of the Review Widget.
Each button also shows the number of reviews that contain that keyword.
For example:
letters (3),quality (5)
When a customer clicks a keyword, the widget filters the review list to show only reviews that include that term.
Matching keywords are also highlighted in the review text for better visibility.
If a product is included in a product group, keywords will not be generated or displayed for that product, even if keyword search is enabled.
To enable keyword search in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
Scroll down to find and click the checkbox next to "Show review keywords".
Click Save.
8. Review section theme
You can choose how the list of reviews is displayed in the Review Widget by selecting a Review section theme. This controls the layout of individual reviews (not the header). To change the review section theme:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Theme dropdown.
Select one of the following themes for the review section:
Standard:
Cards:
Align:
Carousel:
(Optional) When using the Cards theme, the Review Widget always displays 1 column to ensure readability. To choose how many columns of reviews are displayed on desktop:
Open the Number of columns (desktop) dropdown.
Select one of the following options:
4 columns
3 columns
2 columns
1 column
Click Save.
9. Review images
To customize the style of the review images in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Image style dropdown and select one of the following options:
"Thumbnails": Shows all images of each review in a small grid under that review.
"Highlight": Shows one main image, with an overlay (e.g., “+2”) if there are more images in the review.
If you choose "Highlight" as the image style, to set the image ratio, on the Review image ratio dropdown and select one of these aspect ratios:
"Square"
"3:4": portrait
"4:3": landscape
Click Save.
10. Stars size
To set the size of the stars of each reviews in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Stars size dropdown and select one of the following options:
"Small"
"Medium"
"Large"
Click Save.
11. Verified badge style
To adjust the style of the verified badge in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Verified badge dropdown and select one of the following options:
"Bold badge": Shows a filled verified badge icon.
"Standard badge": Shows an outlined verified badge icon.
"Bold text": Shows the word "Verified" inside a filled badge.
"Standard text": Shows the word "Verified" inside an outlined badge.
Click Save.
12. Review text size and length
To set the size and length of the review text in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Review title text size dropdown and choose a font size for the review title:
"Small"
"Medium"
"Large
Open the Review text size dropdown and choose a font size for the review content:
"Small"
"Medium"
"Large
Open the Review text length dropdown and choose how much review text to show:
"Short"
"Medium"
"Long".
Click Save.
13. Content display
To set the size and length of the review text in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
For Content display, to select which details to shown in each review, click the checkboxes next to the following options:
"Show reviewer avatar": Shows the reviewer’s profile icon.
"Show reviewer location": Shows the reviewer’s city and region (if available).
"Show reviewer country flag": Shows the reviewer’s country flag next to their name. Location is not available for reviews imported from AliExpress.
"Show review thumbs up and down": Shows the “Helpful?" label text and thumbs-up and thumbs-down icons in each the review.
"Show social share buttons": Shows the sharing icons for each review. To select which platforms to include, click Click to update selection and click the checkboxes next to platforms you want:
"Facebook"
"X"
"Pinterest"
"LinkedIn"
Click Save.
14. Colors
Available on the Free plan
To customize the colors of the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Color and styling section.
For Color palette, adjust the colors for the following elements:
Star and bar chart color: Sets the color of the review stars and rating filter.
Button color: Sets the background color of buttons (e.g. the Write a review button).
Button text color: Sets the color of the text inside buttons (e.g. the Write a review button).
Text color: Sets the color of regular text (e.g. the reviewer name and review content).
Lighter text color: Sets the color of secondary or less prominent text including:
The review count in the rating filter
The review date
The "Helpful?" label text and the thumbs-up and thumbs-down icons
The social share icons
Click Save.
15. Corner styling
To choose how rounded the corners of the buttons in your Review Widget appear:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Color and styling section.
Open the Corner styling dropdown.
Select one of the following options:
"Square": Shows sharp, right-angled corners.
"Soft": Shows slightly rounded corners.
"Rounded": Shows moderately rounded corners.
"Extra round": Shows fully rounded corners for a softer look.
Click Save.
16. Sorting method
By default, the Review Widget shows the latest reviews first.
You can change the default sorting method to better match your store’s goals—for example, showing the most helpful reviews or those with photos first.
To set your default sorting method:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Display preferences section.
Open the Default sorting method dropdown.
Select one of the following options:
"Most recent": Shows the newest reviews first
"Highest rating": Shows reviews with the highest ratings first
"Lowest rating": Shows reviews with the lowest ratings first
"Only pictures": Shows only reviews that include at least 1 image
"Pictures first": Shows reviews with images first, followed by text-only reviews
"Videos first": Shows reviews with videos first
"Most helpful": Shows reviews with the most thumbs-up (likes) from customers first
Click Save.
17. Pagination
By default, the Review Widget displays 5 reviews per page using pagination. This means customers can navigate through multiple pages of reviews using numbered links at the bottom of the widget.
You can customize both the pagination style and the number of reviews shown per page to better suit your store’s layout and browsing experience.
To adjust the pagination settings of the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Display preferences section.
In the Reviews per page field, enter a number between 1 and 10 to set how many reviews are shown per page. Values outside this range will show a "Number of reviews is invalid" error.
To choose how customers can browse through reviews, open the Pagination type dropdown and select one of the following options:
"Load more button": Shows a button at the bottom of the widget that loads more reviews when clicked.
"Page number": Shows numbered pages customers can click to view more reviews.
Click Save.
18. Widget texts
To customize the texts in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Text section.
In the Widget title field: adjust the default "Customer Reviews" text.
In the Review word (singular) field: adjust the default "Review" text.
In the Reply author name field: sets the name displayed when the store replies to a review.
In the No reviews text field: adjust the default "Be the first to write a review" text.
Click Save.
Customize the Review Widget with Shopify theme editor
Available on the Free plan
To access the Review Widget settings in Shopify theme editor:
From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Edit theme.
At the top of the theme editor, open the template dropdown in the middle.
Select Products, then select Default product.
On the left panel, inside Template, find the Review Widget block you added.
Click the block to open its settings.
Once opened, you can customize these settings of that specific Review Widget block: the preview data, maximum width, Store reviews tab and what to show when the product has no reviews.
1. Preview data
To preview how the Review Widget will look on your product page in different scenarios without affecting how reviews are shown on your live storefront:
Go to the Review Widget settings in Shopify theme editor.
Open the (Preview only) dropdown.
Select one of the following options:
Sample data – shows example reviews so you can see the widget layout and styling.
Real data – shows your actual product and store reviews.
No reviews – shows how the widget appears when there are no reviews yet.
Click Save on the top right.
2. Maximum width
To customize the width of the Review Widget:
Go to the Review Widget settings in Shopify theme editor.
Adjust Maximum width using the slider or by entering a px value (200-1200).
Click Save on the top right.
3. Store reviews tab
By default, the Review Widget shows only the product’s reviews.
To show two tabs in the Review Widget, Product reviews tab for the current product) and Store reviews tab (for your overall store):
Go to the Review Widget settings in Shopify theme editor.
Enable "Show store reviews".
Click Save on the top right.
4. For products with no reviews
To control how the Review Widget shows for products without a review:
Go to the Review Widget settings in Shopify theme editor.
Open the If no reviews show dropdown.
Select one of the following options:
Show empty widget – Displays the Review Widget without any reviews.
Reviews for other products – Shows reviews from other products in your store instead.
Hide widget – Hides the Review Widget entirely until the product receives its first review.
Click Save on the top right.
Customize the Review Widget with CSS
Add custom CSS in Judge.me
To add custom CSS for the Review Widget in Judge.me:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Advanced section at the bottom.
In the Custom CSS (Advanced) editor, add the CSS code you want to use. The Custom CSS editor is limited to 1000 characters and only accepts CSS that begins with
.jdgm-rev,.jdgm-rev-widg, or#judgeme_product_reviews.Click Save.
Add custom CSS in the Shopify theme editor
Available on the Free plan
To add CSS in Shopify Theme Editor for the Review Widget:
From your Shopify admin, go to Online Store > Themes.
Find the theme you want to edit and click Edit theme.
On the left menu, click the Theme settings icon.
Scroll down to Custom CSS and add your CSS code.
Click Save on the top right.
Example CSS you can add in Shopify theme editor to customize elements of the Review Widget:
What you want to change | CSS code |
To change the background color of the Verified badge | .jm-verified-buyer-badge__text { |
Troubleshoot
The "Write a review" button is missing
The "Write a review" button is missing
If you have installed the Review Widget, but you don't see the Write a review button:
On some product pages, you see the reviews (or Review Widget) but not the Write a review button.
On some product pages, you don't see both the reviews (or Review Widget) 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.
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.
Resources
Get your free trial:
📈 Unlock all customization options and more features with a 15-day free trial of the Awesome Plan—start today and enjoy increased social proof and higher conversions.
Follow us on LinkedIn:
📢 Stay in the loop! Follow Judge.me on LinkedIn for the latest product updates, tips, and feature launches.