How to Fix Missing Field hasMerchantReturnPolicy on Shopify

Why Google Merchant Center Flags Missing Return Policy

In 2024, Google elevated return policy transparency from an optional bonus to a mandatory requirement for free Google Shopping listings. When Google crawls your Shopify store, its automated bot looks for a MerchantReturnPolicy object nested inside your product Offer schema. Because most default Shopify themes were designed before this requirement, they lack the necessary liquid tags.

Method 1: The Automated 1-Click Solution (Recommended)

Rather than manually editing complicated theme.liquid files or creating custom snippets that break when your theme updates, Smart Schema provides a native Shopify OS 2.0 Theme App Embed. Once enabled, it automatically calculates and outputs your 30-day return window, shipping cost policies, and return conditions server-side across all products.

Method 2: Manual JSON-LD Implementation

If you prefer to manually write theme code, you must locate your product template file (usually snippets/product-json-ld.liquid or sections/main-product.liquid) and insert the following compliant MerchantReturnPolicy structured data block inside the Offer object.

Code Example: Google-Compliant JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Your Product Name",
  "offers": {
    "@type": "Offer",
    "price": "49.00",
    "priceCurrency": "USD",
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "US",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}

Frequently Asked Questions