Merchant Return Policy Schema Generator

Describe your store's return policy once in JSON-LD: where it applies, how many days customers have, how to return and who pays.

Runs in your browser — nothing you enter is uploaded Free · no sign-up

Validate a live page

    

Paste the code into the page’s <head> or <body>. Valid markup makes a page eligible; Google decides whether to show a rich result. Mark up only content visible on the page. Fields are saved in your browser.

About the Merchant Return Policy Schema Generator

Return information can influence a purchase, and Google can show return details alongside products in shopping-related results. Google supports a MerchantReturnPolicy at organization level, nested in your Organization markup through hasMerchantReturnPolicy, so you do not have to repeat it on every product. The key properties are applicableCountry and returnPolicyCategory; with a finite window you also need merchantReturnDays. returnMethod, returnFees and return shipping fees are recommended.

This return policy schema generator builds the JSON-LD in your browser. Use two-letter country codes such as IN, and choose between a finite window, an unlimited window or no returns. Keep the markup identical to your published returns page. If you also set return policies in Google Merchant Center, keep both consistent, since Google may use the Merchant Center settings. Product-level policies can still override the default for specific items.

How to use it

  1. Select the countries where the policy applies.
  2. Choose the policy category and enter the return window in days.
  3. Set the return method and who pays return fees.
  4. Nest the JSON-LD in your Organization markup and test it.

Frequently asked questions

Where should MerchantReturnPolicy markup go?

For a store-wide policy, nest it inside your Organization markup using hasMerchantReturnPolicy, typically on the homepage or returns page. For products with different terms, add a policy to that product's Offer, which overrides the organization default for that item. Keep both versions consistent with your published returns page.

What return policy categories can I use?

returnPolicyCategory accepts MerchantReturnFiniteReturnWindow for a fixed number of days, MerchantReturnUnlimitedWindow for no time limit and MerchantReturnNotPermitted when returns are not accepted. With a finite window, add merchantReturnDays, for example 7 or 30. Add returnMethod and returnFees as well so shoppers know how returns work and whether they will pay for them.

Does return policy schema replace Merchant Center settings?

No. If you use Google Merchant Center, configure return policies there as well. Google may rely on Merchant Center settings when both exist. The key is that your website's returns page, your markup and Merchant Center all state the same terms.