Google has quietly updated its structured data documentation for merchant return policies and loyalty programs and while it might look like a small clarification, the impact is real for anyone managing e-commerce SEO, Merchant Center feeds, or schema markup.
Let’s break it down.
What’s Changed?
Google updated its documentation for two key features:
1. Return Policy Markup
- Only a subset of organization-level return policies are supported at the offer level.
- Merchant-level return policies now must be defined using
Organizationmarkup (not just embedded in product-level or offer-level schema).
2. Loyalty Program Markup
- Loyalty programs must be defined separately from offer-level loyalty benefits like price reductions or reward points.
- This means structuring them under
Organizationmarkup on a separate page or via Merchant Center. - Shipping and returns loyalty benefits are not supported by Google yet.
Why This Update Matters
This isn’t just about documentation, it’s about cleaning up the confusion that could silently be hurting your visibility in search and Merchant Center listings.
In short:
- If you’re putting all your return policies or loyalty benefits at the offer or product level: you’re doing it wrong.
- If you’ve added return policy schema inline in your product page but not under
Organization: Google may ignore it. - If you’re mixing loyalty program info with price/points at the offer level: that’s now deprecated.
What You Should Do (Checklist)
Here’s how to align with Google’s updated rules:
Use Organization markup for return policies and loyalty programs
Host return policy and loyalty info on separate URLs (or push via Merchant Center)
Keep offer-level loyalty data limited to price and points only
Don’t mix shipping/returns loyalty perks in structured data (not supported yet)
Don’t define global return policies directly inside offer markup
How This Impacts You (By Role)
For SEOs:
Misplaced schema = missed eligibility for enhancements in rich results, product snippets, and Merchant Center integrations.
For Developers:
Revise your JSON-LD or microdata to comply with the updated hierarchy. Start with Organization > hasMerchantReturnPolicy and hasLoyaltyProgram.
For E-commerce Managers:
Ensure your returns and rewards are clearly defined on a standalone policy page. Use Merchant Center for structured program info wherever possible.
Final Thoughts: Clarity Brings Compliance
Google’s move here is subtle, but important. They’re tightening up how structured data is understood less ambiguity, more structured consistency.
For brands and merchants, that means one thing: get your house in order.
Structured data isn’t just about ticking boxes, it’s about earning trust, eligibility, and visibility in a world where Google’s AI-driven systems rely more than ever on clean markup.
Discover more from Rudra Kasturi
Subscribe to get the latest posts sent to your email.