Product Reviews¶
Menu Location: Products > Product Reviews
Last Updated: 2026-07-27
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.
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 - a read-only field showing an admin username; nothing in the system currently sets this automatically when you approve a review, so it typically shows blank/"n/a"
- 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: the photo field exists and can hold an uploaded image, but the photo/video upload control on the customer-facing review form is currently disabled in code, so in practice customers cannot attach a photo to a review today. A photo can still be attached by uploading one directly on this 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¶
This table has a single Status field (On/Off), not a multi-stage workflow:
- Off - default state for a newly submitted review, not yet marked as reviewed/approved
- On - you've reviewed the content and marked it approved
Click the on/off button on any row in the list to flip it directly, no need to open the record.
There are no separate Pending / Rejected / Flagged / Featured states in this system.
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 |
| Approved By | Admin username on record (not auto-set) |
| Admin Notes | Internal note, not customer-visible |
Troubleshooting¶
Reviews Aren't Showing Up on the Website¶
This page is where customer-submitted reviews are recorded and reviewed internally, but nothing in the storefront currently reads from this table to display reviews on product pages. If your shop shows star ratings or reviews on product pages, that's a separate third-party reviews widget (Yotpo), controlled independently of this page. Approving a review here does not publish it to the site.
Customer Says They Can't Add a Photo to Their Review¶
That's expected right now. The photo upload option is disabled on the customer's review submission form. You can still attach a photo to their review yourself from this page if needed.
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¶
- 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
- Review lands here with Status Off
- You read it and set Status to On once you've reviewed it (or delete it if it's not legitimate)
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 here make it show up on my website?¶
No. Nothing in this admin page publishes reviews to the storefront. If your product pages show ratings/reviews, that's coming from a separate integration (Yotpo), not from this table.
Can customers upload a photo with their review?¶
Not currently. The photo upload control on the customer's review form is disabled. You can attach a photo to a review yourself from this page.
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.
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.