Note: This documentation is intended for our Core Platform clients. If you are a Syndication Only client, visit Syndication Only (Using a Standard UGC and Product Feed) or Syndication Only (Using Your Standard Client Feed).
As part of the implementation process, PowerReviews offers clients the ability to import any existing Ratings and Reviews they have collected via another online reviews provider, to ensure they do not lose their legacy data.
PowerReviews reserves the right to moderate all submitted content to ensure it adheres to the PowerReviews Authenticity Policy and PowerReviews Moderation Policy.
Requirements
You must compile your Ratings and Reviews from your previous review provider into a CSV file using UTF-8 encoding. This file must also include all PowerReviews required fields (below). PowerReviews can accept and display emoji characters within supported text fields (e.g., Review Title, Review Text, Review Display). Ensure your import file is UTF-8 encoded to correctly include these characters.
PowerReviews can offer guidance on how to populate any required fields that may be missing from your previous reviews provider. We also recommend contacting your previous reviews provider for instructions on how to export your existing reviews from their solution as soon as possible, if you're not sure how to do this.
Required Fields
You must provide the following fields in your file for PowerReviews to be able to import your data. Match the exact spelling and formatting to ensure your code is accurate.
| Field |
Example |
Description |
Additional Notes |
| Review Id |
3045211 |
The unique ID for the review. |
String. |
| Page Id |
439178561578 |
The unique product identifier, typically the product ID, SKU, style number, or item number.
This value should match the product feed.
Up to 50 alphanumeric characters.
|
This field is case-sensitive and should not include spaces.
The use of hyphens and underscores is supported.
|
| Review Display |
Jim the Runner
Jim S
|
The user's nickname on the review.
Up to 40 characters.
|
String.
Do not include full names or any type of PII.
If no review display is included, it will be populated with Anonymous.
Supports emoji characters.
|
| Review Title |
Effective and Gentle |
The user-entered review title.
Up to 60 characters.
|
String.
If no review title is included, it will be populated with the first 20 characters of the review text.
Supports emoji characters.
|
| Review Date |
01/01/2025 |
The date the user wrote the review. |
Date.
Use MM/DD/YYYY or any other valid date format.
|
| Review Location |
Chicago, IL
USA
|
The physical location of the reviewer.
Up to 40 characters.
|
String.
If no review location is included, it will be populated with Undisclosed.
Supports emoji characters.
|
| Review Text |
This face wash has become a staple in my daily routine. It effectively cleanses my skin without leaving it feeling tight or overly dry, and I've noticed a visible improvement in my skin's clarity since I started using it. |
The main body of comments on the review. |
String.
Supports emoji characters.
|
| Rating |
5 |
The star rating value. |
Whole numbers only, 1-5. |
| Verified Buyer |
Yes |
States whether or not the user is a verified buyer. |
Yes or No only. |
| User Email |
email@email.com |
The reviewer's email address. |
If a review is marked as a Verified Buyer, you must include an email address. |
Optional Fields
You may also include any of the following optional fields in your file. Match the exact spelling and formatting to ensure your code is accurate.
| Field |
Example |
Description |
Additional Notes |
| Variant |
1234_blue |
The variant ID of the product.
This value should match the product feed.
Up to 50 alphanumeric characters.
|
This field is case-sensitive and should not include spaces.
The use of hyphens and underscores is supported.
|
| User ID |
201111045 |
Your unique ID for the user.
|
String.
|
| Recommended |
Yes |
States whether or not the user would recommend the product to a friend. |
Yes or No only. |
| Helpful Votes |
3 |
The number of users who voted that the review was helpful. |
Numeric, non-negative. |
| Not Helpful Votes |
1 |
The number of users who voted that the review wasn't helpful. |
Numeric, non-negative. |
| Merchant Response |
Thank you for taking the time to write a review. We appreciate your feedback! |
The merchant's response was provided to the reviewer to appear along with the review. |
String.
Supports emoji characters.
|
| Images |
https://www.example.com/assets/images/facewash.png
|
A pipe-separated list of image URLs associated with the review. |
Valid, external URL list. |
| Image Captions |
Face wash texture before application. |
A pipe-separated list of image titles and/or captions associated with the review. |
Alphanumeric list. |
| Videos |
https://www.youtube.com/watch?v=AbCdEfGhIjK |
A pipe-separated list of URLs associated with the review. |
Valid, external URL list. |
| Video Captions |
My daily routine! |
A pipe-separated list of video titles and/or captions associated with the review. |
Alphanumeric list. |
| Disclosure Code |
sampling |
If a reviewer received any type of incentive in exchange for writing a review, you must disclose it. |
String.
Required if applicable.
Enter sampling if the reviewer received a free sample.
Enter sweepstakes if any other incentive was offered in exchange for a review.
|
| Locale |
en_US |
The language locale of the collected reviews. |
For more information on our supported locales, see Locale Support & Moderation. |
| IP Address |
192.0.2.1 |
The IP address of the user. |
Valid IP Address.
This field may be required for Syndication.
|
| IovationBlackBox |
0100020000020007gBw_A_eGZ-0-gQy |
The authentication information or fingerprint from iovation. |
String.
This field may be required for Syndication.
|
Based on your previous reviews provider, you may have additional data or fields beyond these, or data that is stored in a different format. Contact your Implementation Team or Account Team to discuss any data you don't see listed above.
Sample File & Import Process
1. Prepare your file to send to PowerReviews, noting the requirements above.
2. Send your file to PowerReviews.
- If you are currently implementing, provide your file to your Implementation Team. Your Technical Implementation Consultant will validate and import the file to your Test and Production accounts.
- If you are an existing client, contact PowerReviews Technical Support to have us upload your file to your Production account.
- Please keep in mind that PowerReviews follows a Data Minimization Policy In terms of data imports, collection, and storage. We may therefore be unable to import certain legacy data points and will inform you if that's the case.
3. In the PowerReviews Portal, navigate to Moderation > Review Moderator Level 2 to approve the content if you are participating in Level 2 Moderation.
Rating Only Imports
We can import star rating reviews that contain no text. Required and optional fields for this importer are listed below.
Note:
- If you have fields associated with your Rating Only reviews that are not listed below, they will not be processed with the import.
- Currently, Rating Only reviews will only display on your site if you have Rating Only collection enabled as well. If you do not want to collect new Rating Only reviews, we can still import your legacy Rating Only reviews in case you'd like to display them in the future.
Required Fields
You must provide the following fields in your file for PowerReviews to be able to import your data. Match the exact spelling and formatting to ensure your code is accurate.
| Field |
Example |
Description |
Additional Notes |
| Review Id |
3045211 |
The unique ID for the review. |
String. |
| Page Id |
439178561578 |
The unique product identifier, typically the product ID, SKU, style number, or item number.
This value should match the product feed.
Up to 50 alphanumeric characters.
|
This field is case-sensitive and should not include spaces.
The use of hyphens and underscores is supported.
|
| Review Date |
01/01/2025 |
The date the user wrote the review. |
Date.
Use MM/DD/YYYY or any other valid date format.
|
| Rating |
5 |
The star rating value. |
Whole numbers only, 1-5. |
| Verified Buyer |
Yes |
States whether or not the user is a verified buyer. |
Yes or No only. |
| User ID OR User Email |
email@email.com or 201111045 |
Either the User ID or User Email must be provided for each rating, but both are not required. |
Unique user ID or the email address associated with the review.
One of the values is required for authenticity purposes.
|
Optional Fields
You may also include any of the following optional fields in your file. Match the exact spelling and formatting to ensure your code is accurate.
| Field |
Example |
Description |
Additional Notes |
| Variant |
1234_blue |
The variant ID of the product.
This value should match the product feed.
Up to 50 alphanumeric characters.
|
This field is case-sensitive and should not include spaces.
The use of hyphens and underscores is supported.
|
| Disclosure Code |
sampling |
If a reviewer received any type of incentive in exchange for writing a review, you must disclose it. |
String.
Required if applicable.
Enter sampling if the reviewer received a free sample.
Enter sweepstakes if any other incentive was offered in exchange for a review.
|
| Locale |
en_US |
The language locale of the collected reviews. |
For more information on our supported locales, see Locale Support & Moderation. |
| IP Address |
192.0.2.1 |
The IP address of the user. |
Valid IP Address.
This field may be required for Syndication.
|
| IovationBlackBox |
0100020000020007gBw_A_eGZ-0-gQy |
The authentication information or fingerprint from iovation. |
String.
This field may be required for Syndication.
|
