How to Add MerchantReturnPolicy and ShippingDetails Schema on Shopify
Satisfy Google AI, Perplexity, and OpenAI merchant trust algorithms by embedding machine-readable return windows, shipping costs, and restocking terms.
Frontier AI shopping models evaluate merchant trust signals before recommending a brand over established retail marketplaces. If your Shopify store lacks explicit hasMerchantReturnPolicy and shippingDetails nested inside product offer schemas, conversational agents lack the structured signals required to confirm customer protections. Embedding Schema.org return policy and shipping microdata provides verified compliance signals that satisfy Google and OpenAI merchant guidelines, reducing exclusion risks in commercial carousels.
How to Implement the Fix
Define Standard Return Parameters
Determine your store's return window (e.g., 30 days), return fees (e.g., FreeReturn), and accepted return methods (e.g., ReturnByMail).
Inject MerchantReturnPolicy & ShippingDetails Liquid
Add this Liquid snippet into snippets/aeo-merchant-trust.liquid to satisfy Google Merchant and AI shopping trust benchmarks:
{%- if template contains 'product' -%}
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": {{ product.title | json }},
"offers": {
"@type": "Offer",
"priceCurrency": {{ cart.currency.iso_code | json }},
"price": {{ product.price | money_without_currency | json }},
"availability": "{% if product.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}",
"url": "{{ shop.url }}{{ product.url }}",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn",
"refundType": "https://schema.org/FullRefund"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": "0.00",
"currency": {{ cart.currency.iso_code | json }}
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 2,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 3,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
}
}
</script>
{%- endif -%}Validate with Google Rich Results & Relayeo App
Test your live product URL in Google's Rich Results Test and activate the Relayeo Shopify App to synchronize shipping changes dynamically.
Why Standard Themes Fail in AI Search
The 'Unknown Return Terms' Penalty
Root CauseWhen a buyer asks ChatGPT 'Find me a winter coat with free 30-day returns', the AI searches for explicit merchantReturnDays: 30. If this is only written in free-form prose on a policy page, the AI crawler cannot verify it and excludes your store.
Ambiguous Shipping Surcharges
Root CauseAI agents favor merchants who declare clear shipping transit times and flat rates. Without OfferShippingDetails, models assume worst-case shipping costs, misrepresenting your final price.
Lower Gemini & Google AI Overview Ranking
Root CauseGoogle's Search Console Merchant Listings report explicitly flags products lacking return policies, disqualifying them from the top 3 AI Overview carousel slots.
Run a 1.1-second scan on your live Shopify theme with zero account required.
Build 100% Machine Trust for AI Recommendations
Deploy verified return policy and shipping microdata to earn prime citation spots in Google AI Overviews and ChatGPT.