Adding the Reviews Widget (Legacy)
The Reviews Widget allows you to showcase your reviews on product pages in a fully customizable format. Each review will appear with a title, review content, and its associated star rating. Design the widget to match the look and feel of your store and customize the default sorting of your reviews to prioritize the order of the reviews shown in the widget.
In this article, you'll learn how to add the Reviews Widget to your store.
Merchants who are using the previous version of the Reviews Widget. If you’re using the new Reviews Widget 3.0, see this article
How it works
Click the links below to view a specific section of the video:
- General Settings(widget performance)
- Filters
- Look & Feel
- Advanced Setup
Installing the Reviews Widget
For detailed installation instructions, choose the relevant platform from the list below:
- Shopify
- Adobe Commerce (formerly Magento) 1
- Adobe Commerce (formerly Magento) 2
- BigCommerce
- Salesforce Commerce Cloud
- Volusion
- WooCommerce
- Generic (all other platforms)
Customizing the Reviews Widget
Number | Element | Description | Path to Element |
---|---|---|---|
1 | Widget | Reviews Widget font | On-Site Widgets > Reviews Widget > Look & Feel > Widget font |
Reviews Widget Background Color | On-Site Widgets > Reviews Widget > Look & Feel > Background | ||
Reviews Widget Background transparency | On-Site Widgets > Reviews Widget > Look & Feel > Transparent | ||
Reviews Widget size | On-Site Widgets > Reviews Widget > Look & Feel > Widget Size | ||
Sort order | On-Site Widgets > Reviews Widget > General settings > Widget Configuration | ||
2 | Stars | Star Icon (image) | On-Site Widgets >Reviews Widget > Advanced Setup > Change Star Icon |
Star color | On-Site Widgets > Reviews Widget > Look & Feel > Stars | ||
3 | Reviewer Avatar | Avatar | On-Site Widgets > Reviews Widget > Look & Feel > Advanced Setup > Upload Avatar |
4 | Review date format | Date format | On-Site Widgets > Reviews Widget > General Settings > Date format |
5 | Primary color | Yotpo logo, shopper names, avatars, filter icon, pagination | On-Site > Reviews Widget > Look & Feel> Primary Color |
Selecting widget performance
The Reviews Widget includes two performance settings that control content delivery versus widget loading time for all Yotpo on-site widgets.
Better performance
Choose this setting for optimal on-site widget performance and to ensure optimal loading time.
Widgets will load faster on-site, however, moderation actions like publishing reviews or changing Look & Feel design settings may take up to an hour to be reflected on your on-site widgets. We recommend this setting only after you've completed the initial widget deployment on your site.
Immediate update (temporary)
Choose this setting only during the initial setup of your on-site widgets. You can think of it as "Developer Mode" or a staging setting that is recommended only during the initial setup and implementation of Yotpo widgets on your site. Moderation actions like publishing a review and Look & Feel design settings will be immediately reflected on your site but widgets will take longer to load. To ensure optimal widget performance, this setting will automatically revert to Better Performance after five days.
Setting the number of reviews per page
This setting affects the number of reviews shown on each page of the Reviews Widget. From the General Settings tab:
- Enter the preferred number of reviews in the Reviews per page.
- Click Save Changes at the bottom of the screen.
Setting the date format
This setting affects the date format of the reviews in the Reviews Widget. From the General Settings tab:
- Select the date format (MM/DD/YY, DD/MM/YY, or YYYY-MM-DD) in the Date format drop-down list.
- Click Save Changes at the bottom of the screen.
Applying filters
The widget leverages Yotpo's latest and most advanced AI algorithms to actively help shoppers make quick, well-informed, buying decisions using the following Smart Filters:
- Star Distribution Filter - Allow shoppers to see the distribution of star ratings for a specific product and click to filter by rating. Star Distribution displays at the top of the Reviews Widget. See example
- Free Text Search - Make your reviews widget searchable to help prospective shoppers quickly pinpoint the reviews they're looking for. See example
- Smart Topic Filters - Help shoppers focus on the topics that matter most when making buying decisions. Smart Topic Filters are automatically generated based on top mentioned topics from your published reviews. Smart Topic Filters are currently available only for English reviews. See example
- Custom Fields Filters - Allow shoppers to filter reviews for specific answers to custom review form questions. This is a great way for shoppers to focus on reviews written by shoppers who share common intent and characteristics. See example
- Metadata Filters - Leverage metadata collected upon order creation to allow shoppers to filter reviews according to customer, order, and/or product-related fields such as membership type, location, delivery type, order history, and more.
Changing the reviewer avatar
This setting affects the picture that appears next to the customer reviews. The default is the initial letter of the reviewer on a colored circle.
From the Advanced Setup tab:
- Click the icon next to Avatar.
- Browse to the file you want to upload.
- Click Open. The avatar changes to the picture you uploaded.
- Click Save changes at the bottom of the screen.
Customizing the star icon
This setting affects the three-star icons (full, half, and empty) that appear in the Reviews Widget. You’ll upload three 200 x 200 px, 500 Kb files, one for each icon: full, half full, and empty.
From the Advanced Setup tab:
- Click the icon to Full Star.
- Browse to the file you want to upload.
- Click Open.
- Repeat these steps for Half Star and Empty Star.
- Click Save Changes at the bottom of the screen.
Restoring the star icons to the default
This setting restores star icons to the default.
From the Advanced Setup tab, click Remove next to the relevant star icon. The star icon reverts to the default values.
Adjusting the Reviews Widget size
This setting affects the size of the Reviews Widget as it appears in your store. You can configure the relative size - as a percentage of the container size on your product page, or the absolute size - in pixels.
From the Look & Feel tab:
- Either:
- Enter the size in the Widget Size field or
- Use the up/down buttons to change the size
- Choose the unit in the dropdown menu.
- Click Save Changes at the bottom of the screen.
Configuring the font
Configure font settings in the Look & Feel tab. You can configure all of the following settings:
Setting | Description |
---|---|
Adjust the Reviews Widget font | Affects the font used in the Reviews Widget. |
Match the text shade to your store | Affects the text shades that appear in the Review Widget.- If your website background color is dark, set the text color to Light.- If your website background color is light, set the text color to Dark. |
Customizing the colors
Configure color settings in the Look & Feel tab.
You can configure all of the following settings:
Setting | Description |
---|---|
Make the Reviews Widget Background Transparent | Affects the transparency of the Reviews Widget on the product page on your website. - Select the checkmark next to Transparent. |
Make the Reviews Widget Background Opaque | Affects the transparency of the widget on the product page on your website. - Deselect the Transparent checkbox. |
Set the Reviews Widget Background Color | Affects the background color of the Reviews Widget on the product page on your website. Please note: This setting only applies if the widget background is not transparent. Either:
|
Set the Primary Color | Affects the color used for the Yotpo logo, shopper names, avatars, filter icon, and pagination. When you change this, your Reviews Widget palette is updated. Either:
|
Set the Star Color | Affects the color used for the stars in the Reviews Widget. If you use a custom reviewer avatar, you cannot change the star color from the default of yellow. If you have changed the star color, it will revert to yellow. Either:
|
Changing the sort order
To change the order the reviews are displayed in the Reviews Widget, from the General Settings tab:
- Drag the sort parameter to the position.
- Click Save changes at the bottom of the screen.
Allowing your customers to sort reviews
To allow your customers to sort reviews on your website, from the General Settings tab:
- Click the checkmark next to Allow your customers to sort reviews on your website checkbox.
- Click Save changes at the bottom of the screen.
To prevent your customers from sorting reviews on your website, from the General Settings tab:
- Deselect the checkmark next to Allow your customers to sort reviews on your website checkbox.
- Click Save changes at the bottom of the screen.
Restoring to default settings
To restore the look and feel to the default Settings:
- Click Look & Feel.
- Click Reset to default.
To restore the advanced customization to the default settings:
- Click Advanced Setup.
- Click Reset to default.
Advanced customizations
Learn about advanced visual customizations to the Reviews Widget in Widget CSS Editor.
Displaying specific review attributes
You can leverage metadata collected upon order creation to allow shoppers to filter reviews according to customer, order, and/or product-related fields such as membership type, location, delivery type, order history, and more!
Using Yotpo's order creation schema, you can configure predefined or custom properties to collect and leverage as filters right in your Reviews Widget. You can also choose whether to reflect this data in-line with each review.
How it works If your Reviews Widget includes metadata filters, you have the option of configuring the widget to load in a pre-sorted and/or pre-filtered state according to the predefined or custom metadata params defined upon order creation.
Available parameters:
Predefined properties are standard metadata parameters you can collect upon order creation:
Predefined Properties | Example |
---|---|
Product Properties |
|
Order Properties |
|
Customer Properties |
|
Custom properties are metadata properties defined by the merchant where the property names and their values can be totally customized to gather specific product, order, or customer parameters. For example, coupon_used, event_type, membership_type, etc.
To learn how to display metadata fields in the Reviews Widget, refer to the Reviews Metadata API Reference
- Metadata filtering is only available for stores built on non-hosted (custom/generic) eCommerce platforms. Contact your Yotpo representative to learn more.
- Review-related metadata takes 6 hours to appear in Yotpo Reviews and on-site.
Updating your widget version
- This process is only relevant to customers on Yotpo plans that include the Widget CSS Editor feature and have it enabled.
- The widget version update will happen automatically on accounts that do not include the feature.
From time to time, Yotpo updates its code and releases the update as a New Widget Version. Updated versions include new features, improve widget performance, resolve bugs, etc.
Most of these updates don't require any action on your part, however, some larger updates may require you to manually update your widget version.
Updating the widget version is only the first step in the troubleshooting process of certain issues.
Updating the widget version could change the existing implementation. To update the widget version:
- From your Yotpo Reviews main menu, go to click On-Site Widgets.
- Next to Reviews Widget, click Edit. If there's an available update, you'll see the following message:
- Click the Preview New Version button. You'll be redirected to the CSS Editor page.
- On this page click Update Widget Version: