Note: Display 4.0 documentation is provided as a courtesy for clients on this older version of PowerReviews. We recommend contacting your Account Manager to discuss upgrading to our newer Display 4.1 version as soon as possible.
This article discusses how to implement Feedless Product Data code on your product detail pages (PDPs) with product variants being present.
To learn more about implementing Feedless without product variants being present, click here. To learn how to troubleshoot your Feedless Product Data code, click here. To learn more about Feedless and its features and considerations, click here.
Installations Steps
1. Ensure you have already installed the PowerReviews ui.js library and render function on your pages with the components you will be using.
2. Paste the code sample directly underneath the review_wrapper_url
variable with a focus on the product: { } object, as you should have already installed the other code.
The sample code below includes only three variants and is meant to illustrate how you should structure your variant data. You are not limited to three variants only, and can add more if needed.
<script src="https://ui.powerreviews.com/stable/4.0/ui.js" async></script>
<script>
POWERREVIEWS.display.render({
api_key: 'API_KEY',
locale: 'LOCALE',
merchant_group_id: 'MERCHANT_GROUP_ID',
merchant_id: 'MERCHANT_ID',
page_id: 'PAGE_ID',
review_wrapper_url: 'WRAPPER_URL',
//*** Start Feedless Product Code ***
product:{
name:'YOUR_PRODUCT_NAME',
url:'YOUR_PAGE_URL',
image_url: 'YOUR_PRODUCT_IMAGE_URL',
description: 'YOUR_PRODUCT_DESCRIPTION',
category_name: 'YOUR_PRODUCT_CATEGORY_NAME',
brand_name: 'YOUR_PRODUCT_BRAND_NAME',
price: 'YOUR_PRODUCT_PRICE',
in_stock: 'PRODUCT_IN_STOCK_STATUS',
variants: [{
name: 'YOUR_VARIANT_NAME_1',
image_url: 'YOUR_VARIANT_IMAGE_URL_1',
upc: 'YOUR_VARIANT_UPC_1',
page_id_variant: 'PAGE_ID_VARIANT_1',
},
{
name: 'YOUR_VARIANT_NAME_2',
image_url: 'YOUR_VARIANT_IMAGE_URL_2',
upc: 'YOUR_VARIANT_UPC_2',
page_id_variant: 'PAGE_ID_VARIANT_2',
},
{
name: 'YOUR_VARIANT_NAME_3',
image_url: 'YOUR_VARIANT_IMAGE_URL_3',
upc: 'YOUR_VARIANT_UPC_3',
page_id_variant: 'PAGE_ID_VARIANT_3',
}]
},
//*** End Feedless Product Code ***
components: {
ReviewSnippet: 'pr-reviewsnippet',
ReviewDisplay: 'pr-reviewdisplay'
}
});
</script>
3. In the product object you created, update all of the fields with the appropriate data below.
Required Fields at the Parent Level
Match the exact spelling and formatting to ensure your code is accurate.
Field | Description | Requirements | Example | Additional Notes |
name | The name of your product. | Use only UTF-8 encoded characters. | Rivno® Jacket | The name will be visible to your customers on the write-a-review page and Follow-Up Email. Internally, the name will be visible in moderation and reporting. |
url | The absolute URL of the PDP. | The URL shouldn’t contain spaces and should always begin with https. | https://www.prdemostore.com/ collections/apparel/products/ womens-fleet-jacket |
The URL will be used to hyperlink the product name on the write-a-review page and for the "continue shopping" link (visible after submitting a review). Internally, you will see this URL in moderation and reporting. |
image_url | The absolute URL where your product image is publicly hosted. | The URL shouldn’t contain spaces and should always begin with https. | https://cdn.shopify.com/s/files/ 1/1595/6395/products/ CUR7_HBM_hero_large.jpg?v=1478881740 |
The image will be visible to your customers on the write-a-review page and Follow-Up Email. Internally, the image will be visible in moderation. |
description | A description of your product. | Avoid using line breaks or HTML tags and entities in the description, and use only UTF-8 encoded characters. | Go for a walk in the forest and stay dry during the rainy season with this slick jacket fully equipped with top of the line water-resistant technology. | The description is used for moderation purposes and is not visible to your customers. |
category_name | The category hierarchy of the product. | The maximum length for this variable is 300 characters. | Apparel > Jackets > Rain Jackets | This field will be available in reporting, allowing you to filter reviews by category. |
brand_name | The product brand. | The North Face | This field is required for Syndication. It will also be available in reporting, allowing you to filter reviews by brand. |
Optional Fields at the Parent Level
If you elect to use any of these fields, match the exact spelling and formatting to ensure your code is accurate.
Field | Description | Requirements | Example |
price | The price of the product. |
This field can include a decimal point. Currency symbols should not be included. |
230.00 |
in_stock | The stock value of the product. | '1' if the product is in-stock or '0' if it is out-of-stock. | 1 |
add_to_cart_url | The hyperlink to add the product to the customer's cart. | https://www.example.com/store/cart-AddProduct?pid=1234&Quantity=1 | |
asin | Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items - used for the Share to Amazon feature. | Must be 10 characters | B00005N5PF |
Required Fields at the Variant Level
Match the exact spelling and formatting to ensure your code is accurate.
Field | Description | Requirements | Example | Additional Notes |
page_id_variant |
The unique product identifier at the child level; this can be the UPC if you do not have a system-defined value. The page_id_variant is determined by you. |
This field can page_id_variant values are case sensitive.
Hyphens ( - ) and underscores |
AXS-345 |
While reviews always roll up to the page_id level, including a page_id_variant will allow you to identify the specific variation of the product being reviewed. |
manufacturer_id |
The manufacturer model or part number. |
xlslmpprod-1790001-a |
This field is required for Syndication. |
|
upc |
The 12-digit Universal Product Code, the 13-digit International Article Number/European Article Number, or 14-digit Global Trade Item Number. |
This field can only be a string of digits and cannot include letters, spaces, or special characters. |
872760558488 |
This field is required for Syndication. |
Optional Fields at the Variant Level
If you elect to use any of these fields, match the exact spelling and formatting to ensure your code is accurate.
If you do not include the fields below, the variant will inherit the data you included at the parent level.
Field | Description | Requirements | Example | Additional Notes |
name | The name of your product variant. | Use only UTF-8 encoded characters. |
Red Rivno® Jacket | The name will be visible to your customers on the write-a-review page and Follow-up Email. Internally, the name will be visible in moderation and reporting. |
image_url | The absolute URL where your product variant’s image is publicly hosted. | The URL shouldn’t contain spaces and should always begin with https. |
https://cdn.shopify.com/s/files/ 1/1595/6395/products/ CUR7_HBM_hero_large.jpg?v=1478881740 |
|
asin | Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items - used for the Share to Amazon feature. | Must be 10 characters | B00005N5PF |
Considerations for Variants
PowerReviews will only collect Product Data for up to 3 variants at a time, selected at random, to avoid overloading the page. If you include more than 3 variants on a given page, multiple page visits will need to occur in order for the code to fire enough pixels to get through all variants.