Skip to main content

Feature specific reviews on any page using custom tags

Written by Chris MaGill

By default, your reviews widget shows reviews in a set order, but you can create multiple widgets across your store, each sorting reviews based on a custom tag. This means a knitwear collection page can show your best knitwear reviews, a seasonal landing page can highlight reviews that mention that season, and a hero widget can pull your highest-impact reviews all from the same pool of reviews.

💡 This works with the Reviews Widget, Reviews Carousel, Media Grid, and Media Carousel.

Step 1: Get your tag ID

  1. Go to On-site Displays → Reviews Widget → Reviews List.

  2. Find the Featured Reviews field and select in the tag you want to use.

  3. Copy the Tag ID that appears. you'll need this in the next step.

  4. Click Save.

🔔 Be sure to save your changes, this sets the tag to public so it can be used in the custom liquid section in the widget. Learn more about creating public tags here.

Step 2: Add the widget to your theme

  1. Open your Theme Customizer and navigate to the page where you want the widget to appear.

  2. Add a new Custom Liquid section.

  3. Copy the snippet for the widget you're using and paste it into the Custom Liquid section:

Reviews (PDP) Widget

<div data-oke-widget
  data-oke-reviews-product-id="shopify-{{ product.id }}"
  data-oke-order-by-tag-id="YOUR_TAG_ID">
  {{ product.metafields.okendo.ReviewsWidgetSnippet }}
</div>

Reviews Carousel

<div data-oke-carousel
  data-oke-reviews-product-id="shopify-{{ product.id }}"
  data-oke-order-by-tag-id="YOUR_TAG_ID"></div>

Media Grid

<div data-oke-media-grid
  data-oke-reviews-product-id="shopify-{{ product.id }}"
  data-oke-order-by-tag-id="YOUR_TAG_ID"></div>

Media Carousel

<div data-oke-media-carousel
  data-oke-reviews-product-id="shopify-{{ product.id }}"
  data-oke-order-by-tag-id="YOUR_TAG_ID"></div>

  1. Replace YOUR_TAG_ID with the Tag ID you copied in Step 1.

  2. Click Save.

💡 The data-oke-order-by-tag-id attribute is what sorts the widget by your custom tag — everything else is the standard widget snippet.

💡 Placing this on a collection page, seasonal landing page, or homepage hero? Remove the data-oke-reviews-product-id line, since {{ product.id }} only resolves on a product page — or use data-oke-reviews-group-id="YOUR_GROUP_ID" to scope it to a set of products.

The reviews in your widget will now be ordered by your custom tag, repeat this process for each individual widget you would like to create.

🔔 Please note that the name of your custom tags will not be visible to customers, reviews assigned with your custom tags act as Featured reviews in the widget when using the custom liquid section.

🔔 There may be a short delay before a newly added tag filters through and the sort order updates.

Related Articles
Did this answer your question?