ubricHelp

How do I add a return policy to product schema?

Rubric check: missing return policy in product data (check id product_no_returns)

A missing return policy means neither your product markup nor your Organization markup says how returns work. Google and AI shopping tools can't show your returns window or whether returns are free.

Free, no card. Your report opens with this check first.

Why it matters for SEO

Google recommends hasMerchantReturnPolicy for merchant listings and can show return details next to your products. It prefers one policy for the whole shop on your Organization markup, with product-level policies only for exceptions. You can also set returns in Search Console or Merchant Center, and those settings take priority over markup.

Does this matter for ChatGPT and AI Overviews?

Shoppers ask AI tools things like "which shops offer free returns". Return terms in your data give the tool a fact to compare, though how much each AI tool uses it isn't published. Rubric can only see your pages, so a policy set only in Search Console won't clear this check.

How Rubric scores it

StandardStandard checks are the baseline every other tier is measured against.

Why this tier: AI shopping shows return policy.

It is judged on every page Rubric scores. It is only judged on online shops.

Every Rubric score starts at 100. When this check fails, it takes up to 12 points off. Even one failing page costs at least 6 points (half of the most), and the rest comes off as the share of affected pages grows. A warning costs less than a failure.

This check doesn't cap your score. It only takes off its own points.

From the engine's scoring files, scoring 2026-v2.1 (engine d5c591d).

How common it is

Found on 34 of 43 sites where Rubric could judge it (79%). That is 32 of 40 judged sites in Rubric's 313-site test set and 2 of 3 sites audited on Rubric between 11 Nov 2026 and 17 Nov 2026 under the current check rules (scoring 2026-11k or later). Measured 17 Nov 2026 with scoring 2026-v2.1.

79% of the sites Rubric could judge have this problem. Check yours.

Free, no card. Your report opens with this check first.

How accurate the check is

Lab test: passed. On test pages built with this problem, it caught 2 of 2. On clean test pages, it stayed quiet 2 of 2 times. (Engine build bbcec7c.)

Real sites: people checked 15 of its findings by hand and 1 was wrong (6.7%). Last checked 14 Nov 2026. That's a small sample, so treat the rate as rough.

Latest review round: 0 of 13 findings judged were still wrong after the last fix.

Lab as of 16 Nov 2026; judged findings as of 15 Nov 2026.

How to fix it

WordPress

  1. WooCommerce doesn't add return policy markup on its own. Check whether your SEO plugin offers it (some schema plugins add it to the Organization or Product).
  2. If not, add one Organization block with the policy to your site's head with a code snippet plugin (see the custom code example).
  3. Also set returns in Google Search Console under Settings > Shipping and returns, so Google has it even if the markup lags.

Shopify

  1. Your return policy page in Settings > Policies is for shoppers. It doesn't add structured data.
  2. Add an Organization block with hasMerchantReturnPolicy to theme.liquid in Online Store > Themes > Edit code, inside <head>, or use a schema app that supports return policies.
  3. If you use Google's shopping channel, set the return policy in Merchant Center as well.

Webflow

  1. Go to Site settings > Custom code > Head code and add one Organization block with your return policy (see the custom code example).
  2. Save and publish. Check it on a product page with Google's Rich Results Test.

Custom code

Add the policy once on your Organization:

html
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"OnlineStore","name":"Acme Outdoor",
 "url":"https://example.com",
 "hasMerchantReturnPolicy":{"@type":"MerchantReturnPolicy",
  "applicableCountry":"GB",
  "returnPolicyCategory":"https://schema.org/MerchantReturnFiniteReturnWindow",
  "merchantReturnDays":30,
  "returnFees":"https://schema.org/FreeReturn"}}
</script>

Use MerchantReturnNotPermitted if you don't accept returns. Saying so is still better than saying nothing.

More product data for ai shopping checks · The full AI SEO glossary

Free, no card. Your report opens with this check first.