Return and shipping policy markup for online shops
Short answer: Google can show return and delivery information next to your products and in knowledge panels if you describe your policies in structured data. Put one standard return policy and one standard shipping policy under your Organization (or OnlineStore) markup, override them per product only where needed, and test with the Rich Results Test. If you also set policies in Merchant Center or Search Console, those settings win over your site markup, so keep everything consistent.
Shoppers compare more than price. "Free returns within 30 days" or "delivered in two days" can be the deciding detail, and Google can surface it in search results when it understands your policies. This guide walks through adding return and shipping policy markup to a UK online shop, step by step. It's about describing your existing policies accurately; what those policies should be is a separate business decision, and consumer rules apply.
Step 1: Write down your actual policies
Before touching code, list your real policies in plain terms:
Returns:
- Do you accept returns? Is there a time limit (e.g. 30 days)?
- Which countries does the policy cover?
- How are returns made: by post, in store, or both?
- Who pays return postage? Is it free, a fixed fee, or the customer's cost?
- What refund do customers get: full refund, exchange, store credit?
- Any exceptions, such as sale items or personalised products?
Shipping:
- Delivery options (standard, express), costs and any free-delivery threshold.
- Handling time (how long before you dispatch) and transit time.
- Where you deliver.
Markup must match what your policy page says. If you're unsure, fix the policy page first.
Step 2: Decide where the markup lives
Google's documentation describes two levels:
- Organisation level: a standard return policy that applies to most or all products, using
MerchantReturnPolicynested under your Organization via thehasMerchantReturnPolicyproperty. Shipping works the same way, withShippingServicenested under Organization viahasShippingService. - Product level: overrides for specific products, placed under the product's Offer (
MerchantReturnPolicyfor returns,OfferShippingDetailsviashippingDetailsfor shipping). Google notes that product-level policies support a more limited set of properties.
For most small shops, organisation-level markup on the homepage or your policy page, plus product-level overrides only for exceptions, is the right balance.
Step 3: Build the return policy block
Google's example uses properties such as:
applicableCountry: the countries the policy applies to (e.g. "GB");returnPolicyCountry: the country where the item is returned to;returnPolicyCategory: for example, a finite return window (MerchantReturnFiniteReturnWindow);merchantReturnDays: the number of days, such as 30;returnMethod: e.g.ReturnByMail;returnFees: e.g.FreeReturn;refundType: e.g.FullRefund;itemConditionandreturnLabelSourcewhere relevant.
Google's documentation also shows how to model different options for customer-remorse returns versus defective items, and seasonal overrides (for instance, a shorter window during a sale period). Alternatively, the documentation allows you to specify a link to your return policy page rather than every detail. Check the documentation's required properties for the version you use.
Step 4: Build the shipping policy block
The ShippingService type lets you describe shipping costs and delivery times that depend on things like product weight, dimensions or delivery location, according to Google. Typical details include the delivery destination, the shipping rate, handling time and transit time. If you offer free delivery above an order value, there are properties to express that.
Keep it as simple as your real policy. A shop with one UK standard rate and one express rate doesn't need a complex matrix.
Step 5: Add it to the page
Place the JSON-LD block in the HTML of the page that carries your organisation markup, often the homepage or about page, or your returns and delivery page. On Shopify, WooCommerce or similar platforms, check whether your theme or an SEO app already outputs organisation markup; extend that block rather than adding a second, conflicting one.
Step 6: Test
Use the Rich Results Test, either with the live URL or by pasting the code. The test supports JSON-LD and shows errors and warnings, with a code explorer that jumps to the problem line. Fix errors, consider warnings, and check that values match your policy page exactly: 30 days in the markup and "14 days" on the page is a problem.
Step 7: Check for competing settings
This step is often missed. Google's return policy documentation lists an order of precedence, from strongest to weakest:
- return settings via the Content API for Shopping;
- settings in Merchant Center or Search Console;
- product-level merchant listing markup;
- organisation-level markup.
So if you, or someone helping with ads, configured return policies in Merchant Center or account-level policies in Search Console, Google uses those rather than your site markup. Google notes that account-level policies set in Search Console are added to Merchant Center automatically. Decide where your policies are managed, and keep the others consistent or empty.
Step 8: Keep it maintained
Add a reminder to your process: whenever returns or delivery terms change, such as seasonal extensions for Christmas, new couriers or new thresholds, update the policy page, the markup and any Merchant Center settings together.
Common mistakes
- Markup that promises more generous terms than the policy page.
- Two plugins writing two different organisation blocks.
- Forgetting product-level overrides for items that can't be returned.
- Setting policies in Merchant Center and then wondering why markup changes don't show.
- Expecting the details to show immediately: Google doesn't guarantee that structured data features will appear.
FAQ
Do I need both return and shipping markup?
No, they're independent. Start with whichever matters more to your customers, often free or easy returns.
Can I just link to my returns page in the markup?
Google's documentation allows a link to your return policy page as an option. Detailed properties give Google more to work with.
I sell internationally. Do I need separate policies?
If terms differ by country, model them separately with the applicable countries for each.
Will this guarantee the details appear in search?
No. Google says it doesn't guarantee features that use structured data will appear.
If your returns and delivery terms are a selling point but never show up in search, send us your policy page and we'll help you describe it in markup that matches.