Product Reviews¶
Menu Location: Products > Product Reviews
Last Updated: 2026-10-12
Overview¶
The Product Reviews page is where customer-submitted product ratings and written reviews land after a customer rates or reviews a product they've actually purchased. Use it to view every submitted review and mark it Approved once you've read it.
Primary Functions:
- View every review a customer has submitted (star rating, headline, written text)
- See which customer, order, and product each review is tied to
- Mark a review's Status On (approved) once you've reviewed it, or leave it Off
- Add an internal note on a review
- Delete a review permanently
- Search/filter the list and sort by any column
How reviews get here: Customers submit them from their account's review page (home/review.php), which only lets a logged-in customer rate/review products from their own past orders. There is no way for a customer to submit a review for something they didn't order. New reviews are screened by an AI first pass: clear ones are auto-approved or auto-denied, and the unclear ones wait in the Review Approval queue.
Page Layout¶
Reviews List¶
The standard list/edit table shows one row per review with these columns (from the table's editable fields):
- Timestamp - when the review was submitted
- Status - a green "on" / orange "off" button you can click right in the list to flip approval status without opening the record (see Review Status below)
- Customer - linked to the customer's record
- Order - the order # the review is tied to, linked to that order
- Order Contents ID - the specific order line item reviewed
- Deliver On - the delivery date of the order item being reviewed
- Product - the product reviewed, linked to that product's edit page
- Stars - shown as 1-5 star icons in the list
- Headline - short headline text the customer entered
- Photo - an uploaded image, if one is attached (see note below)
- Written Review - the customer's full review text (plain text, no HTML formatting)
- Approved By - who set the review's status: an admin username, or 0 when the AI first pass auto-approved it
- Admin Notes - a free-text internal note field (plain text, not shown to customers)
You can also export or print what's currently on screen using the CSV/Print buttons above the list. Since the list is paginated (100 rows per page by default), this exports the current page of results, not the entire review history at once.
Note on photos & video: the single Photo field is a legacy field (one image per review) you can still fill by uploading directly on this page. Customer-attached photos and video are stored separately (several per review) and are governed by the Let customers add photos & video to their reviews toggle on the Review Approval page.
Adding, Editing, and Deleting¶
Clicking a row opens the standard edit form for that review, with the fields above (Status as an On/Off choice, Headline, Photo upload, Written Review, Admin Notes; Stars appears here as a plain editable number rather than the star-icon display used in the list). Deleting a row permanently removes that review from the system. There is no separate "reject" state or undo.
Review Status¶
Each review carries one of three moderation states:
- Pending - submitted, waiting on a decision (shown as Off in this list)
- Approved - published on the product page and counted in the storefront star rating
- Denied - kept off the storefront (also shown as Off in this list)
The AI first pass settles the clear cases, so most rows are already Approved or Denied; the ambiguous ones are decided on the Review Approval queue, where the AI's suggestion is shown next to each pending review.
Click the on/off button on any row in the list to approve (On) or unapprove (Off) directly, no need to open the record. Changing a review's status recomputes the product's storefront star rating.
Search & Filtering¶
The page's Super Search panel lets you:
- Filter by any column using a dropdown of that column's existing values (for example, filter Status to On or Off)
- Run a free-text search across every column at once ("Text Search ALL Columns")
- Sort the list by any column, ascending or descending
There is no separate rating-only, date-range, or verified-purchase filter. Those are just specific values you can pick in the same column dropdowns (for example, filtering the Stars column to 5). Every review already comes from a real, matched order line item, so there is no "unverified" review to filter out.
Common Use Cases¶
Use Case 1: Review New Submissions¶
Goal: Read through newly submitted reviews and mark the legitimate ones approved
Steps:
- Open Product Reviews
- Filter Status to "Off" to see unreviewed submissions
- Read the headline and written review for each row
- Click the on/off button to mark it "on" for reviews you're comfortable with
- Delete anything that's spam or not a genuine review
Use Case 2: Find a Customer's Review¶
Goal: Look up what a specific customer wrote
Steps:
- Use "Text Search ALL Columns" with the customer's name, or filter the Customer column
- Open the matching row to see the order, product, stars, headline, and written review
Use Case 3: Check Reviews for a Specific Product¶
Goal: See what customers are saying about one product
Steps:
- Filter the Product column to the product you want
- Sort by Stars or Timestamp to scan the results
Report Data & Columns¶
| Column | Description |
|---|---|
| Timestamp | When the review was submitted |
| Status | On (approved/reviewed) or Off |
| Customer | Who wrote the review, linked to their record |
| Order | The order the reviewed item was part of |
| Order Contents ID | The specific order line item reviewed |
| Deliver On | Delivery date of the reviewed item |
| Product | The product reviewed |
| Stars | 1-5 star rating |
| Headline | Short headline text |
| Photo | Uploaded image, if any |
| Written Review | Full review text |
| Owner Reply | Public store-owner reply shown under the review, if one was posted |
| Approved By | Admin username on record, or 0 for an AI auto-approval |
| Admin Notes | Internal note, not customer-visible |
Troubleshooting¶
Reviews Aren't Showing Up on the Website¶
Only Approved reviews appear on product pages; a review that is Pending or Denied stays off the storefront. To publish one, approve it on the Review Approval queue. Star ratings only show on a product once it has at least the number of approved reviews set in the Show storefront stars only after this many approved reviews setting on that page.
Customer Says They Can't Add a Photo to Their Review¶
Check the Let customers add photos & video to their reviews toggle on the Review Approval page. When it is off, the customer review form has no upload option. You can always attach a single legacy photo to a review yourself from this page.
Can't Find a Specific Review¶
Use "Text Search ALL Columns" in the Super Search panel rather than trying to browse the full list, especially once you have more than a page of reviews.
Related Pages¶
- Review Approval - the moderation queue where the ambiguous reviews are decided, and where the Google link, minimum-review count, and photo/video toggle live
- Reviews report - volume, ratings, and moderation numbers
- Products - the product catalog each review is tied to
- Orders - the order and order line item each review references
- Customers - the customer account that submitted the review
Typical Workflow:
- Customer completes an order
- Customer rates/reviews a product from that order on their account's review page
- The AI first pass auto-approves or auto-denies the clear ones; the rest wait in the Review Approval queue
- You approve or deny the ones that need a human (or use this list to edit or delete any review)
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| View unreviewed submissions | Filter: Status → Off |
| Mark a review reviewed | Click the on/off button on the row |
| Add an internal note | Open the row, edit Admin Notes, save |
| Attach a photo to a review | Open the row, use the Photo upload control |
| Find a customer's review | Text Search ALL Columns, or filter Customer |
| Find reviews for a product | Filter: Product → select product |
| Sort by rating | Sort By → Stars |
| Export what's on screen | CSV / Print buttons above the list |
| Delete a review | Open the row (or use its delete control), confirm |
FAQs¶
Does approving a review make it show up on my website?¶
Yes. Approved reviews show on the product page and count toward its star rating. Reviews are normally approved on the Review Approval queue; you can also approve one from this list with the on/off button.
Can customers upload a photo with their review?¶
Yes, when the Let customers add photos & video to their reviews toggle is on (Review Approval page). Attached photos go through the same AI screening as the text; a video is always held for a human to check in the moderation queue before it publishes.
Do I need to verify a review came from an actual buyer?¶
No extra step needed. Customers can only submit a review from their own account's review page, and it's always tied to one of their own past orders. There's no way for someone to submit a review without a matching purchase.
What happens when I delete a review instead of leaving it Off?¶
Deletion is permanent and cannot be undone. If you just don't want it counted as reviewed yet, leave Status Off instead of deleting.
Is there a way to bulk-approve a batch of reviews at once?¶
No, each review's status is toggled on or off individually (though the on/off button in the list makes this a one-click action per row).
Can I get a spreadsheet of all my reviews?¶
The CSV export button above the list exports whatever is currently displayed on screen, which is one page of results at a time (100 by default), not the full history in one file.
Recent Updates¶
2026-10-12¶
- Reviews & Ratings feature: approved reviews now publish on the storefront and feed the product's star rating (replacing the old note that nothing read this table).
- Each review now moves through three states (Pending / Approved / Denied) via an AI first pass plus the Review Approval queue, instead of a plain On/Off.
- Owner Reply field added (a public store-owner reply shown under the review).
- Customers can now attach photos and video to a review when the photos & video toggle is on; the single Photo field is now the legacy one-image path.
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.