Product Reviews allows merchants to collect and display customer ratings and reviews for products in their Miva store. Merchants can configure how reviews are submitted and approved, send automated review requests after a purchase, and display ratings, reviews, and a review form on product pages.
Product Reviews is included with Miva and integrates with PageBuilder, making it easier to add and customize the review experience on the storefront.
Stores that are not already using Product Reviews in Miva 26R3 must install the module before configuring it. If the Product Reviews module is already installed, no additional installation is required, and existing configurations, scheduled tasks, templates, and other module functionality are preserved when upgrading to 26R3.
Install Product Reviews
- In the Miva Admin, go to Settings > Modules.
- Search or locate Product Reviews.
- Click Install.
After installation, the Product Reviews: Settings page opens, where you can configure Product Reviews for your store.
Assign Product Reviews to the Product Display Page
To use Product Reviews with the Product Details component in PageBuilder, verify that the Product Reviews item is assigned to the Product Display (PROD) page. You can add Reviews to any page by assigning
- Go to User Interface → Templates → Product Display → Items tab
- Select the Product Display (PROD) page under templates and click the Items tab
- Search for the Product Reviews item.
- Toggle for tgreviews under the Assigned column of the PROD page.
Once the item is assigned, open PageBuilder and verify that the Product Details component displays the expected Product Reviews functionality.
Configure Product Reviews in PageBuilder
The Product Details component in PageBuilder includes three review details that control how ratings and reviews appear on product pages.
- Reviews: Summary: Displays the product's average rating and total review count. Shoppers can select the review count to open the review list or choose Write a Review to open the review form.
- Reviews: List: Displays individual customer reviews, the rating breakdown, and options to filter and sort reviews. It also supports verified buyer indicators, merchant responses, and loading additional reviews.
- Reviews: Form: Opens the Write a Review form in a dialog, allowing shoppers to submit reviews without reloading the product page.
These details can be customized through the Product Details component settings in PageBuilder. Available options include rating icon styles, colors, typography, buttons, sorting, and the number of reviews displayed per page.
Product Reviews Settings
The Product Reviews: Settings page controls how customers submit reviews, how reviews are approved and displayed, and the email notifications associated with Product Reviews.
The page includes settings for review fields, review display and approval, reCAPTCHA, review-request emails, merchant and customer notifications, and the templates used by Product Reviews.
Field Settings
Use Field Settings to control the information customers can enter when submitting a product review.
The standard fields are Name, Email, Location, Title, and Summary. Each field can be configured as:
- Required: The customer must complete the field before submitting the review.
- Optional: The field appears on the review form but does not have to be completed.
- Hidden: The field is not displayed on the review form.
Field settings are also used by the PageBuilder review form, so changes made here determine which fields shoppers see when writing a review.
Review Settings
Review Settings controls how many product reviews are displayed, the order in which they appear, and whether submitted reviews are approved automatically.
Reviews Per Page: Enter the number of reviews to display at a time on the storefront.
Default Sorting Method: Select the order in which reviews are initially displayed. Available options include Default, Most Recent Reviews, Least Recent Reviews, Highest To Lowest Rating, and Lowest To Highest Rating.
Auto Approve Reviews: Select this option to automatically approve submitted reviews. When this option is not selected, reviews must be approved before they appear on the storefront.
reCAPTCHA Settings
Product Reviews supports reCAPTCHA verification to help prevent automated or spam review submissions.
Public Key and Private Key come from Google reCAPTCHA, not Miva. Merchants need to register their website with Google reCAPTCHA to obtain these keys. See the setup instructions in the user docs to get started using reCAPTCHA.
To use reCAPTCHA for Product Reviews, select reCAPTCHA Enabled and enter the Public Key, and Private Key.
Mail After Notification
Mail After Notification automatically sends customers an email asking them to review products they purchased. You can configure the notification to be sent a specified number of days after the order date or shipment date. Product Reviews uses a scheduled task to process these notifications.
Merchant Notification Email
Configures email notifications sent to the merchant when a review is submitted.
Customer Notification Email
Configures email notifications sent to customers related to their review.
Create and Manage Reviews with the Product Reviews: Reviews tab
The Product Reviews: Reviews tab displays reviews submitted for products in your store. Here you can add, approve, delete, and edit existing reviews.
Add a review from the Miva Admin System Extensions > Product Reviews: Reviews.
- Click Add Review.
- Select a Rating.
- Use Lookup to select the product for the review.
- Enter the review information, including the reviewer name, title, and summary. Available and required fields are based on your Product Reviews Field Settings.
- Select Approved if you want the review to appear on the storefront.
- You can select Verified Buyer to identify the review as coming from a verified purchaser.
- Click Add.
Approve Product Reviews
Only approved reviews are displayed on the storefront.
If Auto Approve Reviews is enabled in Product Reviews Settings, submitted reviews are automatically approved and can appear on the product page.
If automatic approval is not enabled, you can approve reviews individually from the Product Reviews: Reviews tab by enabling the Approved toggle for the review.
You can also select a review to edit its information, change its approval status, mark it as a Verified Buyer, or delete the review.
Customer Product Reviews
After Product Reviews is installed, shoppers can view ratings and reviews from the product page and submit their own reviews using Write a Review.
The product page displays the product's overall rating and number of reviews. Shoppers can open the Reviews section to view the rating breakdown, read individual reviews, and sort the available reviews.
A Shopper submits a review by clicking Write a Review on the product page and selecting a rating. To complete the review form they must fill in the required fields set in the Field Settings configured in Product Reviews.
They can opt in for: Notify me when my review is approved. For this, if the review requires approval, the shopper receives a confirmation email that the review was submitted and will be posted after it is approved.
Once approved, the review is included with the other reviews displayed for that product.