How AI agents read your return policy
Return terms can influence the purchase before an item reaches the cart. Keep the policy page, structured fields and post-purchase workflow aligned so customers know what they can return and how the refund works.
Reviewed October 1, 2026 · 7 min read
On this page6 sections
A shopper asking for shoes they can return if they do not fit has made returnability part of the buying decision. People and assistants may check the window, item condition, fees and refund method before recommending or purchasing an offer.
The policy needs to be understandable before purchase and workable afterward. A clear page is useful, but it must agree with any merchant-platform settings, structured data and support process.
Review these three parts together:
| Object | Who reads it | How it goes wrong |
|---|---|---|
| Policy page | Customers and systems reading the site | Ambiguous scope or outdated terms |
| Structured policy data | Supporting shopping and search systems | Missing fields or disagreement with the page |
| Order and refund updates | Customers, support teams and connected applications | A processed change is not reflected in the reported status |
Check the policy shown beside your listings#
A shopping platform may derive policy information from your website as well as accept merchant submissions. Inspect the actual return annotation on important listings, especially when terms or product exceptions change.
Do not assume that an automatically extracted summary matches every detail. Compare it with the applicable policy and use the platform's correction process if it is wrong. Submitting structured data does not guarantee immediate or identical display.
Check what is currently attributed to you
Check the window, fees, country and product exceptions shown on representative listings. Save examples of mismatches so you can trace which source or setting needs correction.
Translate the policy into supported fields#
Google's merchant return policy guidance describes MerchantReturnPolicy markup. For the organization-level record, it supports an applicable country and policy category, or a policy link alternative. Follow the documented requirements for the placement you use.
| Property | Status | What it holds |
|---|---|---|
| applicableCountry | Required with category | ISO country codes, up to 50 |
| returnPolicyCategory | Required with country | One of three values, below |
| merchantReturnLink | The alternative to both | A URL, if you provide nothing else |
| merchantReturnDays | Required for a finite window | An integer |
| returnFees | Recommended | Who pays to send it back |
| returnMethod | Recommended | ReturnByMail, ReturnInStore, ReturnAtKiosk |
| refundType | Recommended | FullRefund, ExchangeRefund, StoreCreditRefund |
| restockingFee | Recommended | An amount or a percentage |
For returnPolicyCategory, Google's documented values distinguish a finite window, an unlimited window and returns not being permitted:
- MerchantReturnFiniteReturnWindow: include the number of return days and make the start of that window clear.
- MerchantReturnUnlimitedWindow: use only when the applicable policy genuinely has no time limit.
- MerchantReturnNotPermitted: use for the applicable policy where returns are not offered, while preserving any mandatory rights and exceptions.
A schema value describes the policy; it does not decide whether that policy is lawful or accepted by a platform. Keep category restrictions, defective-item treatment and applicable consumer rights clear. The following example is illustrative, not a policy to adopt without review:
{
"@context": "https://schema.org",
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn",
"refundType": "https://schema.org/FullRefund"
}Use the documented Schema.org values and validate the result. Also check the meaning: a syntactically valid 'FreeReturn' value is wrong if the customer actually pays a return charge. See the JSON-LD guide for validation basics.
Where it goes, and the nesting people get wrong#
Google supports a standard policy under Organization through hasMerchantReturnPolicy, and product-specific policies under the relevant Offer. The offer-level supported properties are more limited, so do not copy every organization field into an offer without checking.
Google recommends a page describing the business's return policy and says repetition on every page is unnecessary. That is not a blanket ban on consistent repeated markup. Keep one maintained policy source and make exceptions explicit.
Inspect the policy information your site exposes
Use a Nexez scan to review public information and structured data, then validate return-policy fields with the relevant consumer's tools and your own policy owner.
Scan your site freeExplain fees and return reasons#
State who arranges and pays for the return shipment, whether a restocking fee applies and how the customer receives the refund. Use the supported return-fee values and amounts where appropriate. Keep the same explanation on the visible policy page.
Some structured fields distinguish a change of mind from a defective item. Use that distinction where your policy and the target consumer support it. Do not flatten materially different terms into one misleading fee value.
Plan seasonal exceptions before publishing them
If your return window changes for a promotion or holiday period, specify the affected dates and products in the page and supported override fields. Test the start and end boundaries. Markup does not automatically change the rules in your returns system.
Keep the customer informed after purchase#
A return request, received parcel and completed refund are different events. Your support process and connected applications should report the actual state, not treat all three as 'returned.'
Refund and dispute responsibilities depend on the merchant, payment arrangement and platform contract. Identify who handles the request and how the customer reaches them. The agent payments guide explains the relevant boundaries.
For an integrated checkout, follow the exact versioned order-event contract. Authenticate callbacks where required, handle duplicate delivery and reconcile changes with the payment and order systems. Do not assume one protocol's event names or signature scheme applies to every integration.
These are useful business states to track, regardless of the protocol-specific field names:
| Business state | What the customer should understand |
|---|---|
| Return requested | The request was received, not necessarily approved |
| Return authorized | The applicable instructions and deadline |
| Item received | The parcel arrived and any inspection remains pending |
| Refund initiated | The merchant or provider submitted the refund |
| Refund completed or failed | The verified payment outcome and any next step |
Map those states to the events your integration actually supports and provide a support route for information it cannot carry. A partial refund or exchange may need more context than a single order status.
What to do, in order#
- Compare visible policy text with representative shopping annotations and merchant settings.
- Publish supported policy fields, including the correct country, category and finite window where applicable.
- Attach the standard policy and product exceptions at the appropriate level.
- Explain return shipping, restocking, defect and change-of-mind treatment clearly.
- Validate the live markup and check that the operational returns process honors the same terms.
- Test refund and order updates, including retries and partial refunds where supported.
- Review seasonal boundaries and remove expired promotional wording.
The result should be a policy customers can understand and your team can apply consistently. Good structured data communicates that policy; it does not replace the operational process or resolve a dispute on its own.
Keep offer terms consistent across your listings
See how Nexez publishes business and offer information from maintained listings. Keep policy ownership and post-purchase support clear for every sales channel you use.
See how it worksFrequently asked questions
Do I have to offer returns to be listed by AI shopping surfaces?
Requirements vary by platform, category and applicable law. Schema.org includes a value for returns not being permitted, but that value is not a legal exemption or a guarantee of listing eligibility. Publish the actual applicable policy and preserve required rights and exceptions.
What does "For most items" mean on my Google listing?
It is a broad annotation that should be checked against the applicable product and policy. Platforms can derive information from a website as well as merchant submissions. If the displayed terms are wrong, investigate the source and use the platform's correction process.
Should the markup go on Organization or on the product?
Use Organization for the supported standard business policy and an Offer-level record for a relevant product exception. Google supports different property sets at those levels. Follow the current documentation and keep the visible page consistent.
Why does my return policy markup fail validation?
Check the validator's specific error rather than assuming a cause. Common issues include invalid JSON, unsupported properties for the chosen placement and a finite window without the required day count. Validate the meaning against the policy as well as the syntax.
Can I charge for some returns but not others?
Different return reasons can have different terms where the policy, platform and applicable law allow them. Structured fields can describe those distinctions for supporting consumers. Make the visible explanation equally clear and avoid contradicting mandatory customer rights.
Who handles the refund when an agent placed the order?
The responsible merchant or platform must follow the payment arrangement and sales terms. Identify that party clearly and provide a support route. An assistant initiating the order does not automatically take over refund or dispute responsibilities.
Does the protocol track returns the way it tracks shipping?
It depends on the protocol version and implementation. Check the supported order, return and refund events and map your business states to them. Test partial refunds and repeated callbacks where relevant, and provide support information for details the protocol cannot represent.
Keep reading
How AI agents pay: checkout, delegated tokens and x402
An AI agent can help a customer reach checkout, use a delegated payment credential, or pay for a software resource.
9 min readAgent readinessJSON-LD for AI agents: practical schema examples
JSON-LD gives software an explicit description of the facts on your page.
6 min readAgentic commerceACP enrollment: what merchants should check before integrating
Implementing ACP and joining a shopping platform are separate steps.
5 min read