Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Structured product returns #2288

danbri opened this issue Jun 19, 2019 · 3 comments


None yet
3 participants
Copy link

commented Jun 19, 2019

(proposal from Google)

It would be useful for to have expressivity that allowed various merchants to describe their return policies. As always there are various levels of detail that might be made explicit. Our suggestion is to start with something like the following:

Main concepts:

  • Return Policy URL
  • Return Window Type [Finite, Infinite, Final Sale (no returns accepted)]
  • Refund Type [Store Credit, Full Refund, Exchange]
  • Return Fees [Original shipping, return shipping, restocking fees]

Plus these as "useful to have":

  • Are in-store returns offered? [Yes, No]
  • Exceptions [Category, Return Information including window, type, fees]

Exceptions would be things like "this policy applies to everything except fish and electronics..." and are consequently difficult here because of the lack of a common taxonomy to point into. The usual workaround in such a case would be to at least document text or URL values.

@danbri danbri self-assigned this Jun 19, 2019

danbri added a commit that referenced this issue Jun 19, 2019

First cut at #2288 for structured product returns.
Needs definition texts adding. Examples too.

This comment has been minimized.

Copy link
Contributor Author

commented Jun 19, 2019

First cut at an implemented proposal:

Example usage (I've not added this to repo):

"@context": "",
"@type": "Organization",
"name": "Macys",
"url": "",
    "@type": "",
     "productReturnLink": "",
    "productReturnCategory": "Finite",
    "productReturnDays": "180",
    "refundType": "FullRefund",
    "inStoreReturnsOffered": "True",
    "productReturnExceptions": "Apple Products, area rugs, backstage, beauty box, bluemercury, bonus gifts, bridal salon, cosmetics & fragrances, designer brands, dresses, final sale/as is furniture and mattresses, finish line, fur vault, furniture, gourmet food & wine, home accessories, jewelry, last act, lighting, locker room by lids, maternity, mattresses, optical, personal care, small electrics, style your ring, sunglass hut"

danbri added a commit that referenced this issue Jul 2, 2019

Updated to give descriptions for enumeration of return policies.
Also added a disclaimer that the enumeration doesn't capture all
aspects of the policies.
/cc #2288

danbri added a commit that referenced this issue Jul 15, 2019


This comment has been minimized.

Copy link

commented Jul 16, 2019

hasProductReturnPolicy does not pass Google's structured data testing tool. You can paste the snippet in there.


This comment has been minimized.

Copy link

commented Jul 16, 2019

@rhroyston That's probably because there is some inevitable delay between new terms entering the vocabulary specification and they being supported in various testing tools and environments.

The assumption is they will be soon. It might be worth providing feedback in the SDTT to encourage it's support.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.