Fix Missing field “hasMerchantReturnPolicy” (in “offers”) Shopify Product Schema

Are you missing the Google Search Console warning about the field has merchant return policy, “hasMerchantReturnPolicy”, which should be included in your offers Schema? Is your Shopify Product Schema still missing this field of Structured Data? Please, continue reading on how we solved the issue. We did it, already, for the https://www.kidscarz.com.au, and we applied our fix to the relevant Shopify product.liquid template.

First of all, you have probably received a message, but where can I see it, to check if I am missing something?

• look for a warning at your Google Search Console,
• or check about non-critical issues indication at the Google developer’s page

Why did you receive a notification? It is all about a missing field called hasMerchantReturnPolicy.

We remind you about the Google developer’s page (https://developers.google.com/search/docs/appearance/structured-data), where you can test your structured data. Moreover, we also added the shippingDetails Schema Structured Data in the JSON code at https://www.kidscarz.com.au, check it!

In case you are still wondering, there is no major problem with your site. This warning does not mean something is broken with your webpages. The actual reason for this “reminder”, it’s because Google has updated its handling of product schema for returns policies.

How to Add hasMerchantReturnPolicy to Shopify’s Product Schema

Hereafter, we provide you with an example of code to embed.

1️⃣ Where to Edit Your Shopify Theme Code

1. Go to Online Store > Themes in your Shopify admin panel.
2. Click Actions > Edit Code.
3. Locate the product.liquid file (or main-product.liquid in some themes).
4. Find the section where JSON-LD structured data is added (usually inside <script type="application/ld+json">).

2️⃣ How to Insert the hasMerchantReturnPolicy JSON-LD Code

What to do? Just add the following JSON-LD structured data snippet inside your existing product schema:

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "{{ product.title }}",
  "offers": {
     "@type": "Offer",
     "price": "{{ product.price }}",
     "priceCurrency": "AUD",
     "availability": "https://schema.org/InStock",
      "hasMerchantReturnPolicy": {
         "@type": "MerchantReturnPolicy",
         "applicableCountry": "AU",
         "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
         "merchantReturnLink":"https://yoursite.com/policies/refund-policy",
         "merchantReturnDays": 30,
         "returnMethod": "https://schema.org/ReturnByMail",
         "returnShippingFeesAmount": "5.00" or "returnFees": "https://schema.org/FreeReturn"
     } 
  } 
}

📌 Important: Modify applicableCountry, returnPolicyCategory,
merchantReturnLink, merchantReturnDays, returnMethodand,
returnShippingFeesAmount according to your store’s policies.

* The currency mentioned at “priceCurrency”, should be the Official currency, of the country declared at “applicableCountry”!
** Use “returnShippingFeesAmount” or “returnFees“, be careful, not both!

3️⃣ How to Save and Test Your Changes

1. Click Save in Shopify.
2. Go back to Google’s Rich Results Test and test your product page URL.
3. Ensure the hasMerchantReturnPolicy field is detected.

In case you already have an offers schema, then you need to upgrade your code. For this situation, place in your product.liquid only the following piece of code. It is the same snippet as the one above in blue colour. Copy and paste the following solution, in your Product Offers Schema. Access your Shopify Store code as mentioned in the previous step 1, and add the following:

"hasMerchantReturnPolicy": { /* thanks to Efthymios from seomywebsite.net */
         "@type": "MerchantReturnPolicy",
         "applicableCountry": "AU",
          "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
          "merchantReturnLink":"https://yoursite.com/policies/refund-policy",
          "merchantReturnDays": 30,
          "returnMethod": "https://schema.org/ReturnByMail",
          "returnFees": "https://schema.org/FreeReturn"
          },

Pay attention to the comma at the end! It is vital to include it, if the Product Offers Schema JSON code has more than one required or recommended product properties following. Then you can test everything as per step 3.

"shippingDetails": {
  "@type": "OfferShippingDetails",
  "shippingRate": {
    "@type": "MonetaryAmount",
    "value": "5.00",
    "currency": "USD"
  }
}

📈 How This Helps Your Shopify SEO Strategy

By implementing merchant return policy schema, you’re optimizing your Shopify store for:

✅ Higher Click-Through Rates (CTR) – Rich snippets attract more clicks.
✅ Better E-A-T (Expertise, Authority, Trustworthiness) – Google prefers transparent stores.
✅ Fewer Google Search Console Errors – Avoid penalties for missing structured data.
✅ More Conversions – Customers are more likely to buy with clear return policies.

💡 Need Help? Get a Shopify SEO Expert on Your Side!

Tired of struggling with structured data, schema errors, and Shopify SEO? We can fix it for you! 🚀

• Do you have a Shopify return policy?
• Do you know how to create a Shopify return policy?
• Would you like to ask someone, how to fix all missing from your return policy?

✅ Full SEO audits for Shopify stores.
✅ Schema markup implementation to remove all errors.
✅ Technical SEO fixes to boost search rankings.
✅ Conversion optimization to get more sales.

📞 Book a Free Consultation Now → Contact Us

📢 Spread the Word: Know someone facing Shopify schema issues? Share this guide and help them optimize their SEO effortlessly!

In case you don’t feel eligible to implement the merchant return policy code in your Shopify Liquid template, don’t hesitate to contact us, for a fix at your Rich Results Markup. We will add all necessary structured data for you, on every product page.

This code can be applied to any WordPress e-shop or website, too!

For more JSON Structure Data examples, for free, without using any extra plugin, you can also check: how to add FAQ Shopify Schema Markup to your webpage. Just click the previously mentioned link, and you will find out that it is so easy!

Image Attributes: freepik.com

• add structured data
• Schema markup
• Shopify
• structured data for SEO

... Any published article or post on SEO is valid. Since SEO is still in demand, you can follow any posted recommendations to fix your code in order to get a better score on GTmetrix or PageSpeed Insights for the web pages that need it most. Whenever I find time, I continue developing my website.

Also, if you have a new SEO technique or want to publish a fantastic new SEO strategy online that converts into leads or sales, especially in the e-commerce space, please contact me and I will host your (strictly relative) article, with all proper credits to the author, for at least one month.

Moreover, I will be especially happy if I receive from you an email related to search engine optimization in Greek, which is my native language. Of course, I can provide you with any help you need and it concerns SEO in Greek or creating websites, since I have developed the Wordpress theme that you literally read from scratch. If you are an SEO specialist in Greece, share your opinion with me! So do not hesitate to contact me, I am waiting for you for any advice, question or suggestion to improve my site or anything related to SEO in Greece.

My message in Greek
Θα χαρώ ιδιαιτέρως, αν λάβω από εσάς email σχετικό με search engine optimization στα Ελληνικά, τα οποία αποτελούν τη μητρική μου Γλώσσα. Φυσικά, μπορώ να σας παράξω οποιαδήποτε βοήθεια χρειαστείτε και αφορά SEO στα Ελληνικά ή δημιουργία ιστοσελίδων, μιας και έχω αναπτύξει το Wordpress theme που διαβάζετε κυριολεκτικά από το μηδέν. Αν είστε SEO specialists στην Ελλάδα, μοιραστείτε την άποψή σας μαζί μου! Μην διστάσετε, λοιπόν, να επικοινωνήσετε, σας περιμένω για οποιαδήποτε συμβουλή, απορία ή πρόταση για βελτίωση του site μου ή οτιδήποτε σχετικά ώστε να επιτύχουμε το καλύτερο SEO στην Ελλάδα.