--- title: "Product Reviews" description: "Allowing customers to write product reviews is essential for building trust and driving sales." url: "https://docs.j2commerce.com/apps/product-reviews" markdown_url: "https://docs.j2commerce.com/apps/product-reviews.md" last_updated: "2026-10-23T02:33:38+00:00" version: "J2Store 4" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "Apps" url: "https://docs.j2commerce.com/apps" - title: "Product Reviews" url: "https://docs.j2commerce.com/apps/product-reviews" --- # Product Reviews Allowing customers to write product reviews is essential for building trust and driving sales. Reviews provide real, unbiased feedback that helps potential buyers feel confident in their purchasing decisions, especially when they see others sharing positive experiences. This social proof reduces uncertainty, increases credibility, and makes your brand feel more transparent and authentic. Additionally, reviews often answer common questions, highlight real-world benefits, and improve engagement, all of which can lead to higher conversion rates and repeat customers. ## Requirements 1. PHP 8.1.0 + 2. Joomla! 4.x/ Joomla! 5.x + 3. J2Commerce / J2Store 4.x + ## Purchase the App: **Step 1:** Go to our [J2Commerce website](https://www.j2commerce.com/extensions) > Extensions > Apps **Step 2:** Locate the Product Reviews App > click View Details > Add to cart > Checkout. **Step 3:** Go to your My Downloads under your profile button at the top right corner and search for the app. Click Available Versions > View Files > Download Now ## Install the App: Use the Joomla! installer to install the app. Go to System > Install > Extensions > install the app ![Custom Tabs](https://docs.j2commerce.com/images/docs/v4/assets/user-group-3%20%287%29.webp) ## Enable the App Go to J2Commerce > Apps > search for Product Reviews to narrow down your search. Click on the 'X' under Status to enable it. ![Enable custom tab app](https://docs.j2commerce.com/images/docs/shared/reviews-enable1.webp) Click on "Open App" or the Title to start setting up the app. ![J2Commerce All Apps list searched for "review", with the Open App button highlighted on the enabled Product Reviews row](https://docs.j2commerce.com/images/docs/shared/reviews-enable-open1.webp) ## Setting up the App ### Basic Settings tab ![Product Reviews app, Basic Settings tab highlighted: Enable Reviews Yes, Auto-Approve Reviews Yes, Login Requirement Optional, Prevent Duplicate Reviews Yes](https://docs.j2commerce.com/images/docs/shared/reviews-basic1.webp) **Enable Reviews:** Enable or disable the product reviews functionality globally. **Auto-Approve Reviews:** Automatically approve new reviews without moderation. **Login Requirement:** Specify whether users must be logged in to submit reviews. **Prevent Duplicate Reviews:** Select Yes to prevent users from submitting multiple reviews for the same product. *This is important to select Yes so one person can't leave a ton of bad reviews on one product* **Enable Quick Icon:** Select 'Yes' to display the quick icon in the Joomla administrator dashboard. ### Display Settings tab ![Product Reviews app, Display Settings tab highlighted: star placement, Show Average Rating Yes, Reviews Per Page 5, Default Sort Order Most Recent, Form Display Mode Modal Popup](https://docs.j2commerce.com/images/docs/shared/reviews-display.webp) **Product Display Stars:** Select where to display the (summary) product star reviews. In the drop-down menu, you have many options to choose from. The screenshot below shows what it looks like on the frontend if you choose After / Below Product Title ![Product page for MP7 .177 Break Barrel Pellet Gun with the star rating icons highlighted beside the 4.7 score and 25 Reviews link](https://docs.j2commerce.com/images/docs/shared/reviews-product-title2_blur.webp) **Category Display Stars:** Select where to display the (summary) product star reviews in the category display. In the drop-down menu, you have many options to choose from. The screenshot below shows what it looks like on the frontend if you choose Before / Above Product Title ![Storefront Featured Products with two product cards highlighted, showing star ratings with review counts above the product title, price and cart button](https://docs.j2commerce.com/images/docs/shared/reviews-category.webp) **Show Average Rating:** Select 'Yes' to display the average rating score in the star summary. ![Product page for MP7 .177 Break Barrel Pellet Gun with the 4.7 average rating number highlighted next to the stars](https://docs.j2commerce.com/images/docs/shared/reviews-product-title3_blur.webp) **Clickable Star Rating:** Select 'Yes' to make the reviews count a clickable link that scrolls down to the product reviews list. ![Product page for MP7 .177 Break Barrel Pellet Gun with the clickable 25 Reviews link highlighted next to the stars](https://docs.j2commerce.com/images/docs/shared/reviews-product-title_blur.webp) **Reviews Per Page:** Number of reviews to display per page on the frontend. How many reviews do you want to display on each product page? ![Customer Reviews section with the list of individual reviews highlighted, showing reviewer name, Verified Purchase tag, stars, text and photos](https://docs.j2commerce.com/images/docs/shared/reviews-product3.webp) **Default Sort Order:** Default sorting order for reviews. You can choose to have your ratings organized by Most Recent, Highest Rating, or Lowest Rating **Show Rating Distribution:** Select Yes to display the star rating distribution chart. ![Customer Reviews section with the 4.7 average, star total and the 5 to 1 star rating distribution bars highlighted](https://docs.j2commerce.com/images/docs/shared/reviews-product1.webp) **Show User Reviews Tab:** Select Yes to display a tab for logged-in users to view their submitted reviews. They will find this section in their Account Settings on the frontend of the site once logged in. ![Storefront My Account page, My Reviews tab highlighted in the account menu, listing purchased products with ratings and an account icon highlighted](https://docs.j2commerce.com/images/docs/shared/review-account.webp) The customer can easily see all of the products they have purchased and any that haven't received a review. ![Storefront My Reviews list with the Leave a Review button highlighted on a product that has no review yet, beside rated products](https://docs.j2commerce.com/images/docs/shared/review-modal1.webp) **Form Display Mode:** How to display the review submission form. Inline or a pop-up Modal window. The screenshot below shows the pop-up Modal example. ![Storefront Leave Your Review For modal for a product, with Your Rating stars, Review Title, Your Review text area and Add Photos upload area](https://docs.j2commerce.com/images/docs/shared/review-modal.webp) ### Style Tab ![Product Reviews app, Style tab highlighted: Theme Color and Star Color color fields with hex values and an empty Custom CSS box](https://docs.j2commerce.com/images/docs/shared/reviews-style.webp) **Theme Color:** Select the accent color for the reviews theme. **Star Color:** Select the accent color for the review stars. **Custom CSS:** Add any additional css in here. **Do not add any script files in here.** *Note: The screenshot below shows an example of how the two colors are displayed on the frontend* ![Review summary on a product page with a red 4.7 average, orange star icons, Based on 25 reviews and red rating distribution bars](https://docs.j2commerce.com/images/docs/shared/reviews-style1.webp) ### Submission Settings tab ![Product Reviews app, Submission Settings tab highlighted: review length limits, title and image upload toggles Yes, image size and dimension limits, Convert to WebP Yes](https://docs.j2commerce.com/images/docs/shared/reviews-submission.webp) **Minimum Review Length:** Set the minimum number of characters required for review content. **Maximum Review Length:** Set the maximum number of characters allowed for review content. **Require Review Content:** Make the review text content required (star rating is always required). **Enable Review Title:** Select Yes to allow reviewers to add a title to their review. **Enable Image Uploads:** Select Yes to allow reviewers to upload images with their review. **Maximum Images:** Set the maximum number of images allowed per review. They can select multiple images at the same time. **Maximum Image Size (MB):** Set the maximum file size for each uploaded image in megabytes. **Allowed File Extensions:** Comma-separated list of allowed image file extensions. ie: jpg, jpeg, png, gif, webp **Convert to WebP:** Select Yes to have the images automatically convert uploaded images to WebP format for better compression and faster loading. **WebP Quality:** Move the slider to the left/right to determine the quality level for WebP conversion (50-100). Higher values mean better quality but larger file sizes. **Maximum Image Width:** Set the maximum width for uploaded images in pixels. Larger images will be resized. **Maximum Image Height:** Set the maximum height for uploaded images in pixels. Larger images will be resized. **Thumbnail Width:** Set the width for generated thumbnail images in pixels. **Thumbnail Height:** Set the height for generated thumbnail images in pixels. ### Security Settings tab ![Product Reviews app, Security Settings tab highlighted: reCAPTCHA enabled, type reCAPTCHA v2, keys hidden, v3 threshold 0.5, Rate Limit 4 per hour, Honeypot Yes](https://docs.j2commerce.com/images/docs/shared/reviews-security.webp) **Enable reCAPTCHA:** Select Yes to enable Google reCAPTCHA to prevent spam submissions. **Disable For Logged In Users:** Select 'Yes' to disable the recaptcha plugin for logged in users. **reCAPTCHA Type:** Select reCAPTCHA version to use. **reCAPTCHA Site Key:** Your Google reCAPTCHA site key. Go to [Cloud.Google.com](https://cloud.google.com/security/products/recaptcha?utm_source=google&utm_medium=cpc&utm_campaign=na-US-all-en-dr-bkws-all-all-trial-e-dr-1710134&utm_content=text-ad-none-any-DEV_c-CRE_774450158796-ADGP_Hybrid+%7C+BKWS+-+EXA+%7C+Txt-Security-Platform+Security-reCAPTCHA-KWID_333543722374-kwd-333543722374&utm_term=KW_google%20recaptcha-ST_google+recaptcha&gclsrc=aw.ds&gad_source=1&gad_campaignid=22970352189&gclid=CjwKCAiAu67KBhAkEiwAY0jAlUmkNf4Tmc7k7PitfSjOM02U1eKVLmYe2_38ZsJs3waScV3FDzw3lhoCEtAQAvD_BwE) to sign up for one. **reCAPTCHA Secret Key:** Your Google reCAPTCHA secret key. **reCAPTCHA v3 Threshold:** Minimum score for reCAPTCHA v3 (0.0 to 1.0, higher = stricter). **Rate Limit (Per Hour):** Maximum number of reviews a user can submit per hour. **Enable Honeypot:** Add a honeypot field to catch spam bots. ### Email Settings tab ![Product Reviews app, Email Settings tab highlighted: Brand Logo, Cron URL with Copy button, Enable Review Requests Yes, Request Delay 7 days, Trigger Order Status Confirmed](https://docs.j2commerce.com/images/docs/shared/reviews-email.webp) **Brand Logo:** Add your store's brand logo here so it can be used in the emails and email submission pages. A suggested image size is width=1976 & height=109 **Cron URL:** Use this URL to set up a cron job that will automatically send review request emails. The cron should run every 30-60 minutes. **How to set a cron job on your server** Visit the Cron Documentation to learn how to set up a cron job on your server. **Enable Review Requests:** Select Yes to send automated emails requesting reviews after purchase. **Request Delay (Days):** Number of days to wait after order status change before sending review request. **Trigger Order Status:** Select which order statuses should trigger review request emails. A recommended order status would be Shipped. ***\*Note: How to add a new Order Status to the drop-down menu:*** *Open a new tab and go to your J2Commerce > Localization > Order Statuses > New. Once you have created a new status, go back to your app and hit save to refresh it, and it will appear in the drop-down menu. See image below.* ![J2Commerce Dashboard with the Localization menu open and the Order Statuses item highlighted, with J2Commerce selected in the sidebar](https://docs.j2commerce.com/images/docs/shared/digifactu-order.webp) **Token Expiration (Days):** Select the number of days the email token allows customers to leave product reviews, which will expire after placing an order. ### Email Editor tab ![Product Reviews app, Email Editor tab highlighted, with the Available Shortcodes list for customer, product, review link and order values highlighted](https://docs.j2commerce.com/images/docs/shared/reviews-email-editor.webp) **Available Shortcodes:** Use these shortcodes in your email subject and body. They will be replaced with actual values when the email is sent. ![Product Reviews Email Editor with the Send Test Email button highlighted above the Email Subject, Email Body editor and UTM fields](https://docs.j2commerce.com/images/docs/shared/reviews-email-editor1.webp) **Email Subject:** The subject line for the review request email. You can use shortcodes. **Email Body:** The body content for the review request email. You can use shortcodes and HTML formatting. **UTM Source:** Identifies which site sent the traffic (e.g., j2commerce, newsletter). **UTM Medium:** Identifies the marketing medium (e.g., email, cpc, social). **UTM Campaign:** Identifies a specific campaign (e.g., review_request, product_launch). **UTM Content:** Differentiates similar content or links (optional). ### Google Rich Snippets tab ![Product Reviews app, Google Rich Snippets tab highlighted: Enable Rich Snippets Yes, Minimum Reviews 1, individual reviews, variants and merchant listing Yes, currency USD](https://docs.j2commerce.com/images/docs/shared/reviews-google1.webp) **Enable Rich Snippets:** Select Yes to enable Google Rich Snippets (JSON-LD structured data) for products with reviews. This helps display star ratings and review counts in Google search results. **Minimum Reviews:** Minimum number of approved reviews required before adding structured data to a product page. **Include Individual Reviews:** Include individual review details in the structured data. This provides more context to search engines. **Maximum Individual Reviews:** Maximum number of individual reviews to include in the structured data. **Include Product Variants:** Include product variant information (ProductGroup schema) when products have multiple variants. Helps Google understand product variations. **Include Merchant Listing:** Include merchant listing data (price, availability, seller) in the structured data. Enables richer product listings in search results. **Brand Name:** Default brand name to use in structured data. Leave empty if not applicable. **Default Currency Code:** ISO 4217 currency code (e.g., USD, EUR, GBP) for pricing in structured data. ## Manage Reviews tab ![Product Reviews app with the Manage Reviews toolbar button and the Manage Reviews link highlighted above Total, Pending, Approved and Average Rating cards](https://docs.j2commerce.com/images/docs/shared/reviews-manage1.webp) This section allows you to view and edit all of the reviews on one page. ![Manage Reviews list with Reviewer, Rating, Review, Images, Status and Date columns highlighted, plus Status badges and row action buttons for a pending review](https://docs.j2commerce.com/images/docs/shared/reviews-manage3.webp) **Reviewer:** View the name, email and product name **Rating:** How many stars they gave **Review:** The review they wrote **Images:** If they attached any images with their review and how many were uploaded **Status:** The Status of the review. **Date:** The date the review was submitted **Last Tab:** Here you can Edit, Reject, or Delete the review. If the review status is Pending, the Approve option will appear ## View Pending tab ![Product Reviews app with the View 1 Pending link highlighted beside Manage Reviews, Import Reviews and Analytics](https://docs.j2commerce.com/images/docs/shared/reviews-pending.webp) You can Edit, Reject, or Delete the review. If the review status is Pending, the Approve option will appear ![Manage Reviews list filtered to Pending, with the row action buttons (edit, approve, reject, delete) highlighted for the pending review](https://docs.j2commerce.com/images/docs/shared/reviews-pending1.webp) ## Import Reviews tab ![Product Reviews app summary and links bar with the Import Reviews link highlighted next to Manage Reviews, View Pending and Analytics](https://docs.j2commerce.com/images/docs/shared/reviews-import2.webp) This is very helpful if you have reviews from another site that you want to bring them all over at one time ![Import Reviews screen with the Product ID or SKU identifier, Default Status Approved, Skip Duplicate Reviews, Download Sample CSV and Choose File controls highlighted](https://docs.j2commerce.com/images/docs/shared/reviews-import.webp) **Product Identifier:** Choose how products are identified in your CSV file. By the Product ID or the SKU number. **Skip Duplicate Reviews:** Select it if you want the upload to skip all duplicate reviews **Default Status:** Status to assign to reviews that don't have a status column. Either Pending or Approved. **Upload CSV File:** Drag & Drop Your CSV File Start Import: Once your file has been uploaded, select Start Import to begin ### CSV Format Reference Your CSV file must include the following columns. The first row should be the header row with column names. This will help to have a successful upload. ![Import Reviews CSV Format Reference table with Column Name, Required, Description and Example columns highlighted, listing fields such as product_id, rating and status](https://docs.j2commerce.com/images/docs/shared/reviews-import1.webp) **Column Name:** List of column names and how they should appear in your file **Required:** This shows you which columns are required or not. **Description:** Description of the column names **Example:** An example of how it should appear on the frontend and/or backend ## Analytics tab ![Product Reviews app toolbar and summary cards (Total, Pending, Approved, Average Rating), with both Analytics buttons highlighted](https://docs.j2commerce.com/images/docs/shared/reviews-analytics1.webp) **Reviews Analytics** ![Reviews Analytics dashboard with the four summary cards highlighted: Total Reviews, Average Rating, Verified Purchases and Email Engagement, above segmentation charts](https://docs.j2commerce.com/images/docs/shared/reviews-analytics.webp) All of your review stats are laid out clearly. Total reviews, Average Rating, Verified Purchases, Email Engagement. ![Reviews Analytics dashboard with the Reviews Segmentation, Device Segmentation, User Type and Review Sources donut charts highlighted below the summary cards](https://docs.j2commerce.com/images/docs/shared/reviews-analytics4.webp) **Reviews Segmentation:** The number of reviews for each status. ie: Approved, Pending, Rejected, or Spam. **Device Segmentation:** The number of reviews that were submitted from each device type. ie: Desktop, Mobile, Tablet, Unknown **User Type:** The number of reviews that were submitted by either a customer logged in or a one-time guest. **Review Sources:** The number of reviews that were submitted per source. ie: From the product page, from their profile page, from their email, from the back-end, imported list. ![Reviews Analytics Star Distribution bars by rating and Email Metrics panel with emails sent, engaged, pending, expired and a 40% engagement rate](https://docs.j2commerce.com/images/docs/shared/reviews-analytics3.webp) **Star Distribution:** The graph showing the star percentages **Email Metrics:** The engagement rates from the emails that have been sent ![Reviews Analytics tables for Top Reviewers, Most Reviewed Products and Top Rated Products, all highlighted with review counts and average ratings](https://docs.j2commerce.com/images/docs/shared/reviews-analytics2.webp) **Top Reviewers:** A list of the top reviewers and how many reviews they have written, as well as their average star rating **Most Reviewed Products:** A list of products has the most amount of reviews. This is helpful if you want to feature a product based on its reviews. **Top Rated Products:** A list of products that have the highest ratings.