The Review Widget (new version) 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
Depending on when you installed Judge.me, you may already have the Review Widget (new version), or you may need to upgrade.
If you installed Judge.me before December 9, 2025, you can upgrade to the new Review Widget via the in-app upgrade banner.
If you installed Judge.me on or after December 9, 2025, the new Review Widget is likely already enabled by default.
The Review Widget (new version) is not available if your product pages are built using a third-party page builder.
The Sidebar header theme is only compatible with the Standard review section theme.
Upgrade to the new version
Please consider these before upgrading to the new Review Widget:
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 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 in-app 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. 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.
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.
2. 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.
3. Widget texts
Available on the Free plan
To customize the review word and the no review text in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Text section.
In the Review word (singular) field: adjust the default "Review" text.
In the Review word (plural) field: adjust the default "Reviews" text.
In the No reviews text field: adjust the default "Be the first to write a review" text.
Click Save.
4. 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.
5. Widget title
To show the Customer Reviews title at the top of the Review Widget:
Available on the Free plan
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Text section.
Click the checkbox next to Show widget title.
Click Save.
To change the "Customer reviews" title of the Review Widget:
Available on the Free plan
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Text section.
Click the checkbox next to Show widget title.
In the Widget title field, edit the default "Customer reviews" texts (Available only when Show widget title is enabled).
Click Save.
To customize the size and font weight of the widget title:
Available on the Awesome plan
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Widget header section.
To adjust the size of this title:
Open the Header text size dropdown.
Select one of the following options: Small, Medium, Large.
To set how thick or bold this title appears:
Open the Header text weight dropdown.
Select one of the following options: Regular, Bold.
Click Save.
6. 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.
7. 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 show the rating filter in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
In that section, scroll down to Bar chart.
Click the check box next to Show bar chart.
Click Save.
To choose how the rating filter is displayed in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
In that section, scroll down to Bar chart.
Click the check box next to Show bar chart.
Open the Bar chart type dropdown (This setting is only available when Show bar chart is enabled).
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.
Click Save.
To choose how the progress bars in the rating filter are displayed:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Open the Widget header section.
In that section, scroll down to Bar chart.
Click the check box next to Show bar chart.
Open the Bar chart style dropdown (This setting is only available when Show bar chart is enabled).
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.
8. 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.
In that section, scroll down to find and click the checkbox next to Show media gallery.
Click Save.
To display larger media thumbnails whenever the product has at least 3 images or videos:
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.
Click the checkbox next to Show expanded media gallery (This setting is only available when Show media gallery is enabled).
Click Save.
Example of the expanded media gallery:
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.
9. 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.
In that 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.
10. 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 Widget header 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.
11. 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 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 Theme dropdown.
Select one of the following themes for the review section:
Standard:
Cards:
Align:
Carousel:
12. Number of reviews per page
Available on the Awesome plan
To adjust the number of reviews per page for the Review Widget (This setting is only available for the Default, Align, and Carousel review section theme):
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
For the Default and Align theme:
In the Reviews per page field, enter a number between 1 and 15. Values outside this range will show a red "Number of reviews is invalid" error.
For the Carousel theme:
Open the Reviews per page dropdown.
Select one of the following options: 1, 2, 3, 4.
Click Save.
13. Pagination type
Available on the Awesome plan
To adjust the pagination type for the Review Widget (This setting is only available for the Default and Align section theme):
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Pagination type dropdown.
Select one of the following options:
Load more button – Shows a Show more 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.
14. Number of columns (desktop)
Available on the Awesome plan
When using the Cards review section theme, the Review Widget always displays 1 column on mobile devices to ensure readability.
To adjust the number of columns in desktop for the Review Widget (This setting is only available for the Cards section theme):
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Number of columns (desktop) dropdown.
Select one of the following options:
4 columns
3 columns
2 columns
1 column
Click Save.
15. Review section size
Available on the Awesome plan
To adjust the review section size in desktop for the Review Widget (This setting is only available for the Cards section theme):
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
Open the Review section size dropdown.
Select one of the following options: Small, Medium, Tall
Click Save.
16. Transition speed
Available on the Awesome plan
To adjust the transition speed for the Review Widget (This setting is only available for the Carousel section theme):
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
In the Transition speed field, enter a number between 0 and 60 (seconds).
Click Save.
17. 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.
In that section, scroll down to Styling.
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:
Open the Review image ratio dropdown.
Select one of these aspect ratios:
Square
3:4 – portrait
4:3 – landscape
Click Save.
18. 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.
In that section, scroll down to Styling.
Open the Stars size dropdown.
Select one of the following options: Small, Medium, Large.
Click Save.
19. 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.
In that section, scroll down to Styling.
Open the Verified badge dropdown.
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.
20. 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.
In that section, scroll down to Styling.
To set the font size for the review title:
Open the Review title text size dropdown.
Select one of the following options: Small, Medium, Large.
To set the font size for the review content:
Open the Review text size dropdown.
Select one of the following options: Small, Medium, Large.
To set how long the review text will show:
Open the Review text length dropdown.
Select one of the following options: Short, Medium, Long.
Click Save.
21. Content display
To select which review details to show in the Review Widget:
From your Judge.me Admin, go to Settings > Widgets > Review Widget.
Scroll down and open the Review section section.
In that section, scroll down to Content display.
Click the checkboxes next to any 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 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.
Customize the Review Widget in 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.
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 enabled Judge.me app embed and installed the Review Widget, but you don't see the Write a review button on your product page, first check your Review collection settings to see the status of the Write a review button.
If it's set to No one, the Write a review button will be hidden on all products.
If this is intentional, no further action is needed.
If you want to show the Write a review button for all customers, select Everyone (no restrictions) instead.
I've enabled "Show store reviews" but it's not showing
I've enabled "Show store reviews" but it's not showing
If you've enabled the Show store reviews setting in Shopify theme editor for the Review Widget block, but you haven't seen any changes, it's because you're using the legacy version of the Review Widget.
The Show store reviews setting is only supported in the Review Widget (new version).
I've selected "Reviews for other products" but it's not showing
I've selected "Reviews for other products" but it's not showing
If you've selected the Reviews for other products for the If no reviews show setting in Shopify theme editor for the Review Widget block, but you haven't seen any changes, it's because you're using the legacy version of the Review Widget.
The If no reviews show setting is only supported in the Review Widget (new version).
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.
See our latest updates:
➡️ Check our Unboxed page to discover newly launched features and improvements from Judge.me. See what’s new and start using the latest updates to grow your store.