Main Reviews Widget: Customizations

  • Updated

This guide reviews how to customize the Main Reviews Widget’s colours, display types, and more. The directions below apply to all e-commerce platforms.

In This Guide

Enhancing Widget Speed

Here are a few tips to ensure your Stamped main widget loads as quickly as possible! 

  1. Ensure the main Stamped script is installed to your theme files - visit our guide linked here for step-by-step instructions. Make sure that you're using your account's unique API key!
  2. Enable lazy loading ("load more") for your main widget reviews. This can be done in your main widget Settings here:


Customizing Colors

In the Dashboard, go to Settings - Branding - Widgets to change the colors of components in the Main Review Widget.


Theme Color Change the theme colour of the Widget. Here are the components affected by this setting: 
Star Color  Change the color of the stars in the widget: 
Text Color Change the color of most texts in the widget: 
Verified Badge Color Change the color of the verified buyer badge:


Avatar Image The uploaded image will be shown in the replies to reviews/Q&As:


For optimal display, we recommend uploading a square image of 55px x 55px


Go to Settings - Main Widget and you will see the following page:


List Of Widget Settings Available

Here is a table with all the possible settings and illustrations on the section of the widget that is affected for each setting:

Setting Explanation/Examples
Widget Style Change the display style of the widget. Refer to Display Types & Examples
Language Translate the widget to a language of your choice. If the language is not listed in the settings, kindly contact us at
Reviews Per Page Change the number of reviews showing on each page. The default setting is 5 per page if left blank.
Limit Words Limit the number of words shown in each review.
Sort Type Change the way reviews are sorted in the widget. Default option is most recent.
Loading Type Change the method of loading new pages of review. Default option is pagination. 
Date Format Change the date format showing up on the Display Widgets.
Graph Toggle the visibility of the summary graph:


Photo Summary Toggle the visibility of photo summary section (only shown when there's a photo attached to a review):


Sort Options Toggle visibility of the sort options button:


Recommended Percentage Toggle visibility of the recommended percentage section. Only visible when the option is enabled in settings: Feature: Do you recommend this product?

Reviews Tab Toggle visibility of review tab and it's contents:


Customer's Avatar Toggle visibility of customer's avatar in reviews:


Verified Buyer Toggle visibility of verified buyer badge in reviews:


Date Toggle visibility of date on reviews


Questions & Answers Date Toggle visibility of Q&A date (feature available in Business plan and above):


Share Icons Toggle visibility of social sharing icons in reviews:


Vote Icons

Toggle visibility of vote icons in reviews:


Questions & Answers 

Toggle visibility of the Q&A tab, "ask a question" button and any Q&A content (feature available in the Business plan and above): 


Product & variant Toggle the visibility of the product and variant information on each review, which is shown below the review content:



Advanced Options

There are two additional advanced options accessible by navigating from Settings - Widgets - Main Widget to "Options":

Custom Form Filter Toggle the visibility of custom form filter in the widget (only applicable for radio type custom forms):


Free Text Search Toggle the visibility of free text search in the widget (feature available in the Business plan and above):


CSS Editor

Any additional CSS code can be added under this section of the settings, This will ensure that any tweaks in the widget will be carried over with a change of themes/files in your platform.


Display Types and Examples

Note: The masonry and slider styles will not work if the Main Review widget is placed in a tab. We recommend selecting another style instead.







   Slick Slider












Advanced Customization

Below are a list of further customizations possible at the code-level.

a. Shopify Vintage theme, BigCommerce, WooCommerce and other platforms

The following customizations are available for all platforms. However, please note that the value of the attributes may vary depending on the ecommerce platform you're using.

<div id="stamped-main-widget" 
data-product-id="{{ }}" 
data-name="{{ product.title | escape }}" 
data-url="{{ shop.url }}{{ product.url }}"
data-image-url="{{ product.featured_image | product_img_url: "large" |replace: '?', '%3F' | replace: '&','%26'}}"
data-description="{{ product.description | escape }}"
data-widget-language="{{ language }}"></div>
Attribute Value What it does  
data-take-reviews 1 (numeric, max 20) Limit the number of reviews to load per page  
data-take-questions 1 (numeric, max 20) Limit the number of questions to load per page  
data-animation false (boolean) Stops the scrolling to reviews widget on badge rating click  
data-offset 150 (numeric) Adjusts the position of the scrolling to the widget from click of the badge  
data-offset-mobile 150 (numeric) Adjusts the position of the scrolling to the widget from click of the badge on mobile screens  
data-widget-language ISO 2 Letter Language Codes Translate the widget into different languages  
data-widget-type standard, profile, minimal, two-columns, masonry, slider Use a different layout from the selected layout in settings  
data-sort most-recent, highest-rating, lowest-rating, most-votes, least-votes, with-photos, language (*requires business plan) Sort reviews using the selected value  
data-tags-exclude Review's tag (alphanumeric, separated by comma) Excludes reviews that are tagged with the selected tags  
data-tags-include Review's tag (alphanumeric, separated by comma) Includes only reviews that are tagged with the selected tags  
data-search Text to search (alphanumeric) Includes only reviews that contain the search string  
data-linkify true Enable hyperlinks on the review/Q&A content  


b. Shopify 2.0 Customizations

Shopify 2.0 advanced customizations are completed in the Shopify Theme Editor. To edit the Main Widget, click the item within the app block, opening the left navigation panel.



This is what the additional customization options look like in the Shopify Theme Editor:




The following attributes are not available in the Shopify Theme Editor:

  1. data-widget-language > needs to be added within the widget code
  2. data-sort > can be added within the widget code or modified in the Stamped dashboard:  Settings - Main Widget

Was this article helpful?

2 out of 2 found this helpful

Have more questions? Submit a request