Review schema and star ratings
Optional product metafields so Studio Arcana can output aggregateRating in Product JSON-LD for Google Search.
Studio Arcana includes Product structured data (application/ld+json) on product templates. When two standard metafields are set, the theme can also output aggregateRating, which helps Google show star ratings in search for eligible products.
Step 1 — Metafield reviews.rating
In Shopify admin → Settings → Custom data → Metafields → Products → Add definition:
| Field | Value |
|---|---|
| Namespace and key | reviews.rating |
| Type | Rating |
| Storefront access | Read |
The visible name in the admin can be anything clear (for example “Product rating”).
Step 2 — Metafield reviews.rating_count
| Field | Value |
|---|---|
| Namespace and key | reviews.rating_count |
| Type | Integer |
| Storefront access | Read |
Step 3 — Values on each product
- Fill rating and count manually on each product, or
- Install a reviews app (Judge.me, Okendo, Yotpo, and others) that writes these same Shopify keys.
The theme only adds aggregateRating when both metafields are present and the count is greater than zero.
After publishing
Use Google Search Console to monitor structured data. Rich results can take about 1–4 weeks after Google recrawls the product URL.
Technical reference
- Theme Liquid: shopify/themes/studio-arcana/snippets/structured-data-product.liquid
- Internal field spec: see studio-arcana-theme.md in the Arcanum monorepo docs (Product review metafields for JSON-LD).
- Theme merchant README: shopify/themes/studio-arcana/README.md — Review schema and star ratings.
Was this page helpful?
Content is maintained by Arcanum Hollow Labs. For internal engineering notes, see the docs/ folder in the monorepo.