Ratings and Reviews is a Voyado feature that lets you collect, moderate, and display customer reviews directly on your product pages.
By gathering authentic feedback, you can build trust with shoppers, improve product discovery, and use real customer sentiment to drive more informed purchasing decisions.
Before reviews can appear on your site, a number of settings need to be configured — both in the Ratings and Reviews module and in Voyado. This article walks you through the full setup process.
Before you begin
To complete the setup, you'll need:
- Access to the Ratings and Reviews configuration in Voyado
- An API key
- A product feed that includes product IDs at the appropriate level (variant, product, or group)
- A domain and soft login URL for each site you're setting up
The setup needs to be repeated for each site. If you're operating across multiple markets, you'll configure one site at a time.
Configure Ratings and Reviews settings
Navigate to Modules > Reviews in your Voyado environment, then open the Configuration tab.
Enable the widget and review permissions
Turn on Enable rating and review widgets. This activates the review functionality on your site.
Under review permissions, you can enable reviews for:
- Logged-in users
- Guest users
- Identified users
For testing and staging environments, it's fine to enable all three.
Configure review interactions
Enable the following settings to allow customers to interact with reviews:
- Allow upvotes on reviews — yes
- Allow downvotes on reviews — yes
- Show comments — yes
Show reviews across sites
The Show old reviews setting controls whether reviews collected on one site are shown on other sites within the same tenant.
Enable this if you want reviews to be shared across your sites. If you're running multiple brands in the same tenant and don't want reviews to cross over, leave this off.
Set the product feed mapping
Set Product feed mapping to Variant. This tells the system which level of your product hierarchy to use when fetching product data.
Set the retention date
Set the retention date to a high value (such as 9000) during setup to avoid data being cleaned up prematurely. This can be adjusted later.
Add your API key and domain
Enter your API key and your domain. Also enter your soft login URL.
The domain and soft login settings currently need to be entered in two places. This is a known duplication that will be resolved in a future update.
Configure locale
Under locale settings, enter the locale that matches your product feed.
This should align with the locales used in your marketing groups, for example nl or nl-NL depending on how your feed is structured.
If you're unsure, check your product feed or contact your Customer Manager.
Enable the feature toggle and set permissions
- Go to Feature toggles and enable Reviews.
- Go to Permission groups.
- Enable the Reviews flag for both Admin and Config roles.
The feature toggle will be removed in a future release, but it's required during the current beta phase.
Configure AI moderation
Under the AI settings, enable the following:
- Enable automatic approval of reviews
- Enable automatic rejection
You can leave Log AI responses off for now.
The AI model defaults to version 5.1. This will be updated to 4.1 as the new default, and no action is needed on your part.
Set up content restriction rules
Add a content restriction rule to filter out inappropriate content.
Use the example rule provided in the configuration as a starting point and copy it in.
Having at least one rule in place ensures a fallback is always active.
Configure exporting
The Enable exporting reviews toggle controls whether reviews are synced to the Ripple stack, which is the layer that serves reviews on your product detail pages.
Leave this off when you're testing a migration job in staging and want to verify that data is coming in correctly before syncing.
Turn it on when you're ready to push reviews to your live product pages.
Set up service reviews
Service reviews allow you to collect feedback about the overall purchase experience, separate from product reviews.
To enable this, turn on the service review toggle.
Service reviews work by adding a dedicated service product to your product feed.
This product needs three fields:
- ID — set to
service - Item group ID — set to
service - Main category — set to
service
If you want to populate product images in service review emails, those can be added manually.
Price field validation is overridden for service products, so you won't need to include pricing data.
The email trigger for service reviews is handled through an automation. You'll set that up separately. See the automation setup documentation for details.
Understand product ID mapping
When a customer submits a review, it's stored against up to three product ID levels.
These map to how your product hierarchy is structured:
- Product group ID — the level you want to group reviews on, for example a style or color group
- Product ID — the specific color or variant selected
- Product variant ID — the specific size or SKU selected
All three attributes should be included in your widget script, even if your product hierarchy only has one or two levels.
This ensures reviews can be fetched and displayed correctly regardless of how product data is structured in your feed.
On a single-level hierarchy, where customers make no size or color selection, all three values can be the same.
The widget script is implemented via Google Tag Manager.
On each page where you want reviews to appear, the script reads these ID values from the HTML and uses them to fetch and display the correct reviews.
Verify the widget script
- Open your browser's developer tools.
- Right-click the review widget.
- Select Inspect.
You should see the voyado class with the product ID values populated.
You can also check the Console and Sources tabs to confirm the script has loaded and is making requests to Voyado.
Migrate existing reviews
If you're migrating reviews from another platform:
- Go to Module settings > Reviews.
- Download the example import file.
The file includes the following fields:
- Product group ID
- Product ID
- Product variant ID
- Review group ID
- Product feed ID
In most cases:
- The product group ID and review group ID will be the same.
- The product feed ID is typically the product variant ID, but may be the product ID depending on how your feed is structured.
Additional fields in the import file include:
- Review text
- Rating
- Author details
- Verified buyer status
- Creation date
- Likes and downvotes
You can also include custom metadata, such as an external ID or a first name for guest reviewers.
Reviews can be submitted either by a contact, using a contact ID or email address, or as a guest using user_type: guest.
Guest reviews are stored independently and are not linked to a contact record.
Once the file is ready, import it using the import tool in the Reviews tab.
Next steps
Once configuration is complete, set up the review request automation in Voyado.
This automation triggers an email asking customers to leave a review after a purchase.
You'll need to add an email module. Contact your Customer Manager or refer to the automation setup documentation for guidance.