Note: This documentation focuses on the standard method for syndicating UGC and product data by providing a feed in a defined format. If you are looking for the steps related to syndicating using a Specific XML Client Feed generated by your existing platform, please click here.
Brand user-generated content (UGC) is essential for driving sales on retailer websites. Ensuring that the latest UGC is connected to retail products early in the product's lifecycle maximizes its impact on consumer shopping behavior and conversions. PowerReviews offers a seamless Syndication integration to help you display fresh UGC on your retailer partner websites within the PowerReviews network.
This integration involves two key components:
- Product Data, such that we can match your brand's products to the retailer's products
- UGC, including Ratings and Reviews and Visual Content
This article contains the following sections:
Product Data
PowerReviews will use the Product Data you provide us to match products across the PowerReviews network. This information should be provided via a Product Feed.
To create a Product Feed:
- Click to download a sample CSV file. You should format the file with UTF-8 encoding, and with no byte order mark (BOM).
- Edit the sample file you downloaded with your own product catalog information, keeping the PowerReviews' field names as column headers.
- Send your file to PowerReviews for processing.
Required Fields
The fields listed in the table below are required for every PowerReviews Product Feed import. Match the exact spelling and formatting to ensure your code is accurate.
| Field | Example | Description | Additional Notes |
| page_id | 439178561578 |
The unique product identifier; typically the product ID, SKU, style number, or item number. This value should match the review import file. Up to 50 alphanumeric characters. |
This field is case-sensitive and should not include spaces. The use of hyphens and underscores is supported. |
| product_url | https://www.example.com/ product.jsp?item=1234 |
The full URL of the product detail page on your website. Up to 650 characters. |
This field should not contain spaces. |
| name | Widget1 |
The name of the product. Up to 500 characters. |
Encode all special characters. |
| image_url |
https://www.example/com/ image/1234.jpg |
The full URL of the product image. Up to 650 characters. |
Encode all special characters. Ensure you use a high-quality image. The image should be at least 350 pixels in one dimension. |
| brand | Samsung |
The product brand. This value must accurately match the brand name given on your website. Up to 50 characters. |
|
| upc | 872760558488 (upc) or 0872760558488 (ean) or 00872760558488 (gtin) |
The 12-digit Universal Product Code or the 13-digit European Article Number or the 14-digit Global Trade Item Number. |
This field should not contain spaces or special characters. Only one UPC is supported per product. If you have multiple UPCs, you will need to include a line for each variant. |
Optional Field
The field listed below is optional. However, if you need to use it for products with multiple variations (e.g., UPCs), you must also include all of the required fields listed above in the 'Required Fields' section. In any case where you use the optional field, match the exact spelling and formatting to ensure your code is accurate.
| Field | Example | Description | Additional Notes |
| page_id_variant | 1234_blue |
The variant of the product. This field is used primarily when the page_id has multiple item-level variants such as color or quantities. For more information on how to include variants in your Product Feed, see Page IDs & Page ID Variants. Up to 50 alphanumeric characters. |
This field is case-sensitive and should not include spaces. The use of hyphens and underscores is supported. If you do not have any other system-generated variant identifier, UPC can be used for this. |
| description | A superior widget for every requirement. An essential part of any widget collection. |
The long product description. No limit. |
HTML markup shouldn't be included in the description. You must escape all double quotes. If your data contains special characters, ensure you enclose the entire value in quotes. |
Note: You must escape all double quotes in the 'description' field. If your data contains special characters, ensure you enclose the entire value in quotes.
UGC Integration
To ingest your UGC into PowerReviews for Syndication to retailers, we require a CSV file containing all required fields. This is the only format we are able to accept for this process.
To create your UGC file:
- Click to download a sample CSV file. You should format the file with UTF-8 encoding, and with no byte order mark (BOM).
- Edit the sample file you downloaded with your own UGC information, keeping the PowerReviews' field names as column headers.
- Upload your file to your own SFTP, the PowerReviews-provided SFTP, or provide a public URL. If you choose to use your own SFTP, provide PowerReviews the necessary location and credentials required to access the file. If you wish to use the PowerReviews-provided SFTP (best practice) and do not have your credentials, please reach out to your Account Team.
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. |
| 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. |
| 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. |
| 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 or comments on the review. | String. |
| 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. |
| Locale | en_US | The language locale of the collected reviews. | For more information on our supported locales, see Locale Support & Moderation. |
| 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. |
| User ID | 201111045 | Your unique ID for the user. |
String. Leave this blank if the reviewers weren't authenticated before writing the review. |
| Images | Valid external URL list | A pipe separated list of image URLs associated with the review. | |
| Image Captions | Alphanumeric list | A pipe separated list of image titles and/or captions associated with the review. | |
| Merchant Response | Thank you for taking the time to write a review. We appreciate your feedback! | The merchant's response provided to the reviewer to appear along with the review. | String. |
| Videos | Valid YouTube list | A pipe separated list of YouTube URLs associated with the review | |
| Video Captions | Alphanumeric list | A pipe separated list of video titles and/or captions associated with the review | |
| 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. |
If you have any questions regarding these Syndication requirements, contact your PowerReviews Account Team.