A

Policy

LOW

MerchantReturnPolicy enrichment enums use valid Schema.org values

When present, `returnFees`, `returnMethod`, and `refundType` are members of their Schema.org enums. Invalid enrichment values are dropped silently, leaving merchants confused about why their rendered policy is missing fields they configured.

What this check looks for

Accepted values are: **returnFees** — FreeReturn, ReturnFeesCustomerResponsibility, ReturnShippingFees, RestockingFees, ReturnFeesFinanceResponsibility. **returnMethod** — ReturnByMail, ReturnInStore, ReturnAtKiosk. **refundType** — FullRefund, ExchangeRefund, StoreCreditRefund. Bare enum names and `https://schema.org/`-prefixed URLs both pass; anything else (freeform prose, lowercased values, typos) fails.

Which AI surfaces it affects

  • Google AI Mode (UCP)90
  • Microsoft Copilot60
  • Meta AI50
  • ChatGPT (ACP)40
  • Perplexity30

Weighted against the live specs — ACP 2026-04-17, UCP 2026-04-08.

How to fix it

Use Schema.org enum values for returnFees / returnMethod / refundType

Shopify

Developer
  1. If you hand-roll the JSON-LD, swap any prose values for the schema.org URL form.
  2. Shopify Markets emits valid enums by default — confirm in browser view-source.

BigCommerce

Developer
  1. Edit your product template to map your returns-config values to schema.org enum URLs.

WooCommerce

Developer
  1. Yoast/AIOSEO MerchantReturnPolicy add-ons emit schema.org URLs by default — confirm in view-source.

Custom / headless

Developer
  1. Pick a value from each enum and emit it verbatim.
"returnFees": "https://schema.org/FreeReturn",
"returnMethod": "https://schema.org/ReturnByMail",
"refundType": "https://schema.org/FullRefund"

The spec it's pinned to

  • Google return-policy SD — enum field constraints

    Google's return-policy SD documents `returnFees`, `returnMethod`, and `refundType` as enum-typed fields. Values outside the Schema.org enums are silently dropped, even when the rest of the policy is valid.

Google — return-policy structured data ↗

Does your store pass this check?

Run the full audit — 82 checks across five AI shopping surfaces. Most tools only check whether you get mentioned; we check whether an agent can buy from you.

Related policy checks

← All 82 checks