Technical Definition & Architecture

Google Merchant Center requires explicit definition of return windows to grant free return badges on Shopping ads. The returnPolicyCategory property must be set to an official schema.org enumeration.

For stores offering 14, 30, 60, or 90-day return policies, MerchantReturnFiniteReturnWindow is the correct enumeration, paired with the merchantReturnDays integer property.

Smart Schema defaults to a compliant 30-day return window with FreeReturn fees, directly clearing Search Console return policy diagnostics.

Syntax Example for Shopify JSON-LD

"hasMerchantReturnPolicy": {
  "@type": "MerchantReturnPolicy",
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
  "merchantReturnDays": 30,
  "returnFees": "https://schema.org/FreeReturn"
}
Automate Google Compliance with Smart Schema Pro

Stop editing raw liquid theme templates. Smart Schema injects verified, error-free structured data server-side in 60 seconds.

Start 14-Day Free Trial

Frequently Asked Questions

What should I use if my store has an all sales final policy?

If you do not accept returns, set returnPolicyCategory to https://schema.org/MerchantReturnNotPermitted.

Related Implementation Guide

See our in-depth tutorial on how to implement and troubleshoot this property:

Fix Missing hasMerchantReturnPolicy in Shopify ->