Import Product Reviews Using CSV
Overview
Rivyo lets you import product reviews in bulk using a spreadsheet file. This is ideal when you:
- Are migrating from another review app
- Already have reviews stored in a spreadsheet
- Collected reviews outside your Shopify store and want them to display on product pages
After you upload your file, Rivyo matches each review to the correct product and adds the reviews to your store.
Supported file formats
Rivyo accepts the following file formats:
.csv.xlsx.xls
.csv (CSV UTF-8) and keep your column names simple and consistent.
Import product reviews (CSV upload)
From your Shopify Admin, open the Rivyo app.
In Rivyo, go to Reviews → Import Reviews.
Make sure Product Reviews is selected.
Click Import from CSV or apps, then choose Import from CSV.
Upload your CSV file, then click Import Review.
Rivyo will process the file and add the reviews to the matching products.
After the import finishes, review the results in Import Review History (details below).
CSV required fields
Your file must include the following fields (columns). If any required field is missing, reviews may not import correctly.
| Field | What it means | Example |
|---|---|---|
| Product ID or Product Handle | Identifies which product the review belongs to. | 1234567890 or classic-tshirt |
| Name | Reviewer name shown on the review. | Alex Johnson |
| Reviewer email address. | [email protected] |
|
| Rating | Star rating value from 1 to 5. | 5 |
| Date | Review date in YYYY-MM-DD format. |
2026-03-07 |
Optional fields (recommended)
You can include extra columns to create richer reviews. These fields are optional, but strongly recommended when available:
- Review title (headline shown above the review)
- Review body or description (the main written review)
- Customer images (if your import format supports image links)
- Verified purchase (if you want certain reviews labeled as verified)
Import options
When importing reviews, you can choose additional options:
Approve all reviews
Turn this on if you want imported reviews to be automatically approved and eligible to show on your store right away. If you leave it off, imported reviews may stay unpublished until you approve them.
Skip existing reviews
Turn this on to help prevent duplicates. Rivyo will skip reviews that already exist in your store.
CSV example (template)
Here’s a simple example you can copy into a CSV file. Your column names should match the fields you’re using.
Product Handle,Name,Email,Rating,Date,Review title,Review body
classic-tshirt,Alex Johnson,[email protected],5,2026-03-07,Perfect fit,"Great quality fabric and fast shipping."
classic-tshirt,Sam Lee,[email protected],4,2026-03-05,Good value,"Fits well. Color is slightly darker than photos."
Date format exactly as YYYY-MM-DD. Dates like 03/07/2026 may fail or import incorrectly depending on your spreadsheet settings.
Import review history
After importing, go to Import Review History to review what happened. This is the best place to confirm whether your file processed successfully.
You can typically see:
- Import date
- File name
- Successful imports
- Total rows
- Status (completed, failed, or partially completed)
Tips for successful imports
- Use one product identifier consistently: choose either Product ID or Product Handle and ensure it’s filled in for every row.
- Confirm product handles: a single typo in a handle can cause reviews to import without matching a product.
- Keep ratings valid: ratings must be whole numbers from 1 to 5.
- Standardize your dates: make sure every row uses
YYYY-MM-DD. - Remove extra commas in CSV text: if your review body contains commas, ensure your spreadsheet exports proper quoted CSV (most do automatically).
- Test with a small file first: import 5–10 rows to confirm formatting before importing thousands.
Troubleshooting
- Check whether the reviews are approved. If you didn’t enable Approve all reviews, you may need to approve imported reviews before they publish.
- Confirm your storefront review widget/blocks are enabled and placed on product pages (theme settings can affect visibility).
- Make sure Product ID or Product Handle matches an existing product.
- Check required fields for blanks (Name, Email, Rating, Date).
- Verify the
Datecolumn usesYYYY-MM-DD. - If Skip existing reviews is enabled, duplicates may be skipped by design.
This is usually caused by spreadsheet auto-formatting. Set the date column to plain text before exporting, then re-export as CSV and import again.
Often yes. Exports vary between apps. Ensure your file contains all required fields and that each row includes a valid product identifier (Product ID or Product Handle) that matches your current Shopify catalog.