Loox automatically creates product metafields that store your review ratings and review counts. These metafields let you display review data anywhere across your store - on collection pages, featured product sections, cart drawers, and more - using Shopify's Liquid templating or compatible apps and themes.
Loox supports both its own Loox-specific metafields and Shopify's standard review metafields, giving you flexibility in how you use your review data.
Why use standard metafields?
Shopify's standard metafield definitions (reviews.rating and reviews.rating_count) are a shared format that any compatible theme or app can read. When Loox writes your review data to these metafields, you get:
- Better theme compatibility - Modern Shopify themes are built to read standard metafields, so your ratings and review counts can appear throughout your store without extra setup.
- Flexibility across apps - Other apps in the Shopify ecosystem can access your review data through the same standard format, making integrations smoother.
- Native theme features - You can take advantage of built-in Shopify theme functionality that relies on standard metafields, without writing custom code.
How it works
Every time a product review is published or updated, Loox automatically updates your product metafields in two namespaces at the same time.
Loox namespace:
loox.avg_rating- The average rating stored as a number with decimals (e.g., "4.5").loox.num_reviews- The total number of reviews stored as a whole number (e.g., "42").loox.reviews- The multi-line text content of your reviews (e.g., "Loved this product!").
Shopify standard namespace:
reviews.rating- The average rating stored in Shopify's rating format, which includes the value, a minimum scale of 1.0, and a maximum scale of 5.0.reviews.rating_count- The total number of published reviews stored as a whole number (e.g., "42").
This dual approach keeps everything working for your existing Loox widgets and features, while also making your review data available in the standard format that Shopify themes and other apps expect.
Accessing standard metafields in your theme
If you want to use standard metafields directly in your Shopify theme's liquid templates, you can reference them like this:
{{ product.metafields.reviews.rating.value }} - Displays the average rating value.
{{ product.metafields.reviews.rating_count }} - Displays the total number of published reviews.
Tip: Many modern Shopify themes already include built-in support for these standard metafields. Check your theme's documentation to see if ratings and review counts are displayed automatically.
Availability and requirements
This feature is available on all Loox plans and is enabled automatically for every store.
For the standard metafields to populate with data, your products need to have at least one published review. Products without reviews will not have metafield values set.
What about existing reviews?
Standard metafield updates are triggered by new review activity - when a review is published, unpublished, or updated. Reviews that were published before our integration with Shopify's standard metafields launched will not have standard metafields set automatically.
If you need standard metafields populated for your existing reviews, contact our Support team and we can sync your metafield data for you.
Disabling standard metafields
If you prefer that Loox does not write to Shopify's standard metafields - for example, if another app is managing those metafields for you - you can opt out. Contact our Support team and we can disable standard metafield updates for your store.
When standard metafields are disabled, Loox continues to update only the loox.avg_rating and loox.num_reviews metafields as before.
FAQs
Q: Will enabling standard metafields affect my existing Loox widgets or features? A: No. Loox continues to update its own metafields (loox.avg_rating and loox.num_reviews) as always. The Shopify standard metafields are written alongside them, so nothing changes for your current setup.
Q: What happens if I uninstall Loox? A: When Loox is uninstalled, metafields in both namespaces are cleaned up automatically.
Q: I use another review app alongside Loox. Will this cause conflicts? A: If another app is also writing to Shopify's standard review metafields, the values may overwrite each other. In this case, contact our Support team to figure out a setup where only one app manages them.
Q: My existing reviews don't have standard metafield data. How do I fix this? A: Contact our Support team and we can run a sync to populate standard metafields for all your existing reviews.
Q: Do I need to do anything to start using standard metafields? A: No. This feature is enabled automatically for all Loox merchants. As reviews are published or updated, the standard metafields are created and kept up to date.
If you have more questions, contact our Support team. We're available 24/7 and happy to help!
Powered by Froala Editor
