MerchantReturnPolicy schema markup enables Google to surface your return policy details directly in product rich results and Google Shopping. Showing a clear return policy increases buyer confidence and can improve click-through rates. Valid MerchantReturnPolicy structured data is nested within Product or Offer schemas on your product pages.
| Property | Type | Description |
|---|---|---|
applicableCountryrich result | Country or ISO 3166 code | The country where this return policy applies (e.g. 'US', 'GB'). |
returnPolicyCategoryrich result | MerchantReturnEnumeration URL | The type of return policy (e.g. https://schema.org/MerchantReturnFiniteReturnWindow). |
Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.
| Property | Type | Description |
|---|---|---|
merchantReturnDays | number | Number of days the return window is open. |
returnMethod | ReturnMethodEnumeration URL | How returns are made (e.g. https://schema.org/ReturnByMail, ReturnInStore). |
returnShippingFeesAmount | MonetaryAmount | The cost of return shipping. |
refundType | RefundTypeEnumeration URL | Type of refund offered (e.g. https://schema.org/FullRefund). |
itemCondition | OfferItemCondition URL | Condition in which items may be returned. |
Rich result type: Return policy in merchant product listing
Requirements: Required: applicableCountry (ISO 3166 country code) and returnPolicyCategory (a schema.org URL defining the policy type).
{
"@context": "https://schema.org",
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnMethod": "https://schema.org/ReturnByMail",
"returnShippingFeesAmount": {
"@type": "MonetaryAmount",
"value": "0",
"currency": "USD"
},
"refundType": "https://schema.org/FullRefund",
"itemCondition": "https://schema.org/NewCondition"
}Validate this schema against Google's requirements in one API call:
curl "https://schemacheck.dev/api/v1/validate" \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonld":{"@context":"https://schema.org","@type":"MerchantReturnPolicy","applicableCountry":"US","returnPolicyCategory":"https://schema.org/MerchantReturnFiniteReturnWindow","merchantReturnDays":30,"returnMethod":"https://schema.org/ReturnByMail","returnShippingFeesAmount":{"@type":"MonetaryAmount","value":"0","currency":"USD"},"refundType":"https://schema.org/FullRefund","itemCondition":"https://schema.org/NewCondition"}}'100 free validations/month. No credit card required.