Schema Markup on Your Live Site
Output enhanced JSON-LD on your Shopify storefront using the app embed or a manual Liquid snippet.
When you push schema markup to Shopify, it is saved as a product metafield that belongs to the Rezolve Ai app. Your storefront must output that metafield in the page so search engines can see the enhanced JSON-LD.
Recommended: theme app embed
Install the Rezolve Ai app and enable the Product structured data app embed in the theme editor (Online Store, Themes, Customize, App embeds). It injects your enhanced schema into the <head> on the product template, and always reads the app's latest copy. On your home page it also states your return policy. App embeds work on vintage themes and Online Store 2.0. There are no extra settings for this embed in the theme editor.
Open the Schema screen in the app to see all of the Rezolve Ai storefront blocks and their status, each with an Enable in theme editor deep link. The screen lists seven blocks:
| On the Schema screen | In the theme editor | What it does |
|---|---|---|
| JSON-LD product schema | Product structured data | Invisible structured data in the page head, from the schema you approved in Review. |
| IRL scenario card | IRL scenario card | A visible card of real-life usage scenarios on the product page. |
| Internal links | Internal links card | Related-product links generated from your catalog. |
| Highlights | Highlights | Short benefit bullets from the highlights you approved. |
| Product Q&A | Product Q&A | Shopper questions and answers, also published as FAQ structured data. |
| ACP feed discovery | Agentic Commerce Protocol feed discovery | A head tag that tells AI shopping agents where your product feed is. |
| A/B test | A/B test product description | Splits shoppers between your current copy and a challenger while an experiment runs. |
The IRL scenario card, Highlights and Product Q&A also come as positioned blocks, alongside a Specifications block, which you place inside the product template yourself instead of letting the embed choose the spot.
Use Re-check theme after you enable and save an embed to refresh its status.
The deep link targets your current live theme. To use a draft theme, open it first (Online Store, Themes, then Customize on the theme you want), then go to App embeds.
- Open App embeds in the theme editor.
- Turn Product structured data on for Rezolve Ai, then save. Turn it off in the same place to stop JSON-LD output from this app.
- Preview a product page and confirm structured data before publishing.
Why don't I see the enhanced schema on my product page? The app stores enhanced schema in a product metafield. Until the app embed is enabled (or you add the manual snippet below), Shopify will not surface that JSON-LD on the storefront.
Return policy
With the app embed on, your home page tells search engines your return policy, so they can show your real terms. It comes from the return rules you set in Shopify (Settings, Policies) and is read again once a day. Rezolve Ai never fills in a policy for you.
- If return rules are off, your store states no policy.
- If you use market-specific policies, each market's countries get that market's terms. This needs market access, which the Feeds screen asks for. Without it your store states no policy.
- The policy describes your store as a whole. It does not list final sale items.
To see it, open your home page, view page source and search for MerchantReturnPolicy.
Manual Liquid snippet (advanced)
The app embed is the supported way to output schema. If you prefer not to use it, add the following where the product object is available (for example, in layout/theme.liquid inside <head>, scoped to product templates). It reads a product metafield that the app keeps up to date alongside its own copy, so snippets added earlier keep working. This version falls back to Shopify's default {{ product | structured_data }} when the metafield is empty.
Do not use this snippet together with the app embed. Both would output product structured data, and you would duplicate schema.
{% comment %}
Enhanced schema from Rezolve Ai.
Add in theme layout <head> or product template, only if NOT using the Rezolve Ai app embed.
{% endcomment %}
{% if template.name == 'product' %}
{% if product.metafields.seo.json_ld.value != blank %}
<script type="application/ld+json">
{{ product.metafields.seo.json_ld.value | json }}
</script>
{% else %}
<script type="application/ld+json">
{{ product | structured_data }}
</script>
{% endif %}
{% endif %}In Online Store 2.0 themes, you can add this in the theme layout file (for example, layout/theme.liquid) inside the <head> tag. Save and preview before publishing.
Verify it's working
- Open a product page, view page source (for example, right-click, then View Page Source), and search for
application/ld+json. You should see a script block with your enhanced schema. - Use Google's Rich Results Test or Schema Markup Validator with your product URL to confirm the structured data is detected.