Policy
HIGHMerchantReturnPolicy finite-window has positive merchantReturnDays
Finite-window return policies carry `merchantReturnDays` as a positive number. AI agents quote your concrete return window in shopping cards. Without `merchantReturnDays`, your policy renders as 'has a return policy' without the headline number.
What this check looks for
When a MerchantReturnPolicy node's `returnPolicyCategory` is `MerchantReturnFiniteReturnWindow`, `merchantReturnDays` must be set to a positive number (a typed integer is preferred; numeric strings are also accepted because real-world emitters often produce them). Negative, zero, or non-numeric values fail.
Which AI surfaces it affects
- Google AI Mode (UCP)90
- Microsoft Copilot60
- Meta AI50
- ChatGPT (ACP)40
- Perplexity30
Weighted against the live specs — ACP 2026-04-17, UCP 2026-04-08.
How to fix it
Add a positive `merchantReturnDays` to finite-window return policies
Shopify
Developer- Settings → Markets → policies: set the return window in days for each market's returns policy.
- Verify the emitted JSON-LD on a PDP includes `merchantReturnDays: <number>` for finite windows.
BigCommerce
Developer- Edit your product template to read the configured returns-window days and emit `merchantReturnDays` on the MerchantReturnPolicy block.
WooCommerce
Developer- Configure the days field in your SEO plugin's MerchantReturnPolicy add-on (Yoast or AIOSEO).
- Or hook `woocommerce_structured_data_product` and inject `merchantReturnDays` from your store option.
Custom / headless
Developer- Set `merchantReturnDays` as a number (typed integer is preferred).
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30
}The spec it's pinned to
Google return-policy SD — merchantReturnDays required for finite windows
When `returnPolicyCategory` is MerchantReturnFiniteReturnWindow, Google's return-policy SD requires `merchantReturnDays` as a positive number — without it, the policy can't render the concrete window in rich results.
Does your store pass this check?
Run the full audit — 82 checks across five AI shopping surfaces. Most tools only check whether you get mentioned; we check whether an agent can buy from you.