Comment on page

Reviews Widget

Overview
A high-impact, visually stunning review display widget that is proven to engage shoppers and increase conversions. Extensively customizable and optimized for page-load speed.
Installation
Shopify Online Store 2.0
Shopify Vintage Theme
Instructions for a Shopify Online Store 2.0 installation can be found here.
1.Create a new liquid snippet in the snippets folder with the following name: snippets/okendo-reviews-widget.liquid
2.Inside your newly created liquid file, add the following HTML snippet:
<div data-oke-widget></div>
3.Customize your snippet with the data attributes listed here.
4.Copy the following snippet and place it in your Theme Code where you would like the widget to appear: {% render 'okendo-reviews-widget', product: product %}
​
For more detailed instructions, read our help centre article.
Styling
The preferred method of configuring the Reviews Widget is via the Okendo Admin which can be accessed in the Okendo app via Reviews -> On-Site Displays:
Data Attributes
Use these data attributes on the widget markup to customize its configuration. None of these attributes are required.
Data Attribute
Description
Value Type
Supported Values
data-oke-reviews-product-id
Used to specify a Shopify Product ID with the word shopify- in front of it. The reviews widget will only show reviews for the specified product.
string
Any valid product ID in the format shopify- e.g. shopify-1234567.
data-oke-reviews-group-id
Used to specify an Okendo Group ID so that the reviews widget only shows reviews for the specified group of products.
string
Any valid product group ID in a GUID format e.g. 69d2e67d-b980-4333-97b7-30411807a7b1
data-oke-reviews-ask-question-product-id
Used to show the “Ask a Question” in the reviews widget to leave a question for the specified product.
string
Any valid product ID in the format shopify- e.g. shopify-1234567.
data-oke-reviews-write-review-product-id
Used to show the “Write a Review” in the reviews widget to write a review for the specified product.
string
Any valid product ID in the format shopify- e.g. shopify-1234567.
Examples
Giving The Widget A Data Source
Without specifying a data source for the reviews, the widget will show all reviews for your store. You can provide either a Product ID or a Group ID to use that as the data source for the reviews.
Product Widget
<div data-oke-widget data-oke-reviews-product-id="shopify-<PRODUCT_ID>"></div>
The product widget also has some pre-rendered content stored in Shopify Metafields that we recommend including for increased performance on-site:
<div data-oke-widget data-oke-reviews-product-id="shopify-<PRODUCT_ID>">
    {{ product.metafields.okendo.ReviewsWidgetSnippet }}
</div>
Grouped Widget
<div data-oke-widget data-oke-reviews-group-id="<GROUP_ID>"></div>
Specifying a Product To Ask About
When the widget is in all-reviews or grouped mode an explicit Product ID is needed to show the "Write a Review" or "Ask a Question" buttons.
Write A Review Product ID
<div data-oke-widget data-oke-reviews-write-review-product-id="<PRODUCT_ID>"></div>
Ask A Question Product ID
<div data-oke-widget data-oke-reviews-ask-question-product-id="<PRODUCT_ID>"></div>
​

Data Attribute	Description	Value Type	Supported Values
`data-oke-reviews-product-id`	Used to specify a Shopify Product ID with the word `shopify-` in front of it. The reviews widget will only show reviews for the specified product.	`string`	Any valid product ID in the format `shopify-` e.g. `shopify-1234567`.
`data-oke-reviews-group-id`	Used to specify an Okendo Group ID so that the reviews widget only shows reviews for the specified group of products.	`string`	Any valid product group ID in a GUID format e.g. `69d2e67d-b980-4333-97b7-30411807a7b1`
`data-oke-reviews-ask-question-product-id`	Used to show the “Ask a Question” in the reviews widget to leave a question for the specified product.	`string`	Any valid product ID in the format `shopify-` e.g. `shopify-1234567`.
`data-oke-reviews-write-review-product-id`	Used to show the “Write a Review” in the reviews widget to write a review for the specified product.	`string`	Any valid product ID in the format `shopify-` e.g. `shopify-1234567`.