Showcase your product’s average star rating and total number of reviews anywhere in your Shopify store using Judge.me metafields. This is a great way to boost trust and drive conversions by giving shoppers quick access to social proof.
What are Judge.me metafields?
Judge.me provides two standard Shopify metafields that help you dynamically display key review data on your storefront:
Average rating
{{ product.metafields.reviews.rating.value }}
Example: Displays “4.3” out of 5Total number of reviews
{{ product.metafields.reviews.rating_count }}
Example: Displays “125”
You can also show the minimum and maximum rating scale values:
Minimum rating value
{{ product.metafields.reviews.rating.value.scale_min }}
Example: Displays “1.0”Maximum rating value
{{ product.metafields.reviews.rating.value.scale_max }}
Example: Displays “5.0”
Note: These metafields return raw numbers only. You can wrap them in text to provide better context (e.g., Rated 4.3 out of 5 or 125 reviews).
Other Judge.me metafields
In addition to the standard Shopify review metafields, Judge.me creates several other metafields you may see in your Shopify admin:
App-namespaced metafields (newer Shopify format):
app--2519111--reviews.review_average_rating— average ratingapp--2519111--reviews.review_count— total review countapp--2519111--reviews.review_totals— rating distribution (1–5 stars breakdown)
The 2519111 is Judge.me's Shopify app ID and is the same for all stores — it's safe to reference in your code.
Judge.me widget metafields:
judgeme.badge— pre-rendered HTML for the Star Rating Badgejudgeme.widget— pre-rendered HTML for the Review Widgetjudgeme.review_widget_data— structured JSON data used by the Review Widget
These widget metafields enable Judge.me widgets to render instantly on page load without an extra API call.
Shop-level metafields (for store-wide totals):
shop.metafields.judgeme.all_reviews_count— your store's total published review countshop.metafields.judgeme.all_reviews_rating— your store's overall average rating
Note: To query metafields via Shopify's Storefront API, the metafield definition must have Storefront access enabled:
Go to Shopify Admin → Settings → Custom data → Products → click the metafield → enable "Storefronts."
How to add Judge.me metafields to your Shopify theme
Follow these steps to display Judge.me metafields anywhere on your product pages (or other template files):
Step 1: Access your Shopify theme code
Go to your Shopify Admin.
Click on Online Store > Themes.
In your Current theme, click the ⋯ (Actions) menu and select Edit code.
Step 2: Find the right template file
Open the template where you want to show the review data (e.g.,
product.liquid,main-product.liquid).
Step 3: Insert the metafield code
Paste the following code snippet in the location where you want the rating and review count to appear.
<span>This product is rated {{ product.metafields.reviews.rating.value }} out of {{ product.metafields.reviews.rating.value.scale_max }}</span>
<br>
<span>({{ product.metafields.reviews.rating_count }} reviews)</span>
You can customize the text and styling using HTML or CSS to match your brand better.
Step 4: Save and preview
Click Save in the code editor.
Preview your store and navigate to a product page to confirm the data is displayed correctly.
