---
title: How to add a merchant return policy to your WooCommerce product schema
url: "https://www.seopress.org/support/guides/how-to-add-a-merchant-return-policy-to-your-woocommerce-product-schema/"
lang: en-US
updated: 2026-07-31
---

# How to add a merchant return policy to your WooCommerce product schema

Shoppers hesitate when they cannot see your return conditions. Google can display them directly in search results and in free product listings, but only if your site declares them in structured data. SEOPress PRO does it for you from a single screen, with no code.

## What you need before starting

- WooCommerce and SEOPress PRO 10.1 or newer.
- Your Knowledge Graph set to an Organization type. Go to **SEO > Social Networks > Knowledge Graph** and pick an Organization type (not “None”, not “Person”). The return policy is attached to your Organization schema, so this step is required.
- The Social Networks feature enabled in SEOPress.

## Step 1: open the settings

Go to **SEO > PRO > WooCommerce**, then open the **Return policy (Schema.org)** panel at the bottom of the page.

Turn on **Enable return policy**. The other fields appear right away.

[![Return policy settings for WooCommerce - SEOPress PRO](https://www.seopress.org/wp-content/uploads/2026/07/seopress-pro-woocommerce-seo-schema-scaled.png)](https://www.seopress.org/wp-content/uploads/2026/07/seopress-pro-woocommerce-seo-schema-scaled.png)

*Return policy settings for WooCommerce – SEOPress PRO*

## Step 2: fill in the two required fields

These two are mandatory. If either one is missing, nothing is added to your schema.

**Applicable countries** Start typing a country name and select it. Add every country your policy covers, up to 50. Most stores only need the countries they ship to.

**Return policy category** Choose one of the three options:

- *Returns accepted within a number of days*: the standard case for most stores.
- *Unlimited return window*: no time limit.
- *Returns not permitted*: you do not accept returns at all.

**Return window (days)** This field only appears if you chose “Returns accepted within a number of days”. Enter the number of days from delivery during which a return is accepted, for example 30. Leave it empty and Google will consider your policy incomplete, so always fill it in.

## Step 3: complete the optional fields

They are optional for SEOPress, but Google uses them to build a richer result. Fill in as many as you can.

**Return policy country** The country items are shipped back to, as a two letter code (FR, US, DE). Only useful if it differs from where the order was shipped from. Leave empty otherwise.

**Return method** How the customer sends the item back: *By mail*, *In store* or *At kiosk*.

**Return fees** Who pays:

- *Free return*: you cover everything.
- *Customer pays the return*: the customer covers the return.
- *Customer pays the return shipping*: the customer pays a shipping fee that you can specify.

**Return shipping fee** This field only appears if you chose “Customer pays the return shipping”. Enter the amount, for example 4.99. Your store currency is used automatically.

**Refund type** What the customer gets back: *Full refund*, *Exchange* or *Store credit*.

**Accepted item condition** The condition an item must be in to be accepted: *New*, *Used*, *Refurbished* or *Damaged*.

Click **Save changes**.

## Step 4: check the result

Your policy is now published in two places:

1. On your homepage, inside the Organization schema, as `hasMerchantReturnPolicy`.
2. On every WooCommerce product page, inside the product Offer, so Google sees it where it matters most.

To verify, open the Rich Results Test and run it on your homepage, then on any product URL. You should see the return policy in the detected structured data.

Here is what a typical output looks like:

```
"hasMerchantReturnPolicy": {
  "@type": "MerchantReturnPolicy",
  "applicableCountry": ["FR"],
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
  "merchantReturnDays": 30,
  "returnPolicyCountry": "FR",
  "returnMethod": "https://schema.org/ReturnByMail",
  "returnFees": "https://schema.org/ReturnFeesCustomerResponsibility",
  "refundType": "https://schema.org/ExchangeRefund",
  "itemCondition": "https://schema.org/UsedCondition"
}
```

## Nothing shows up? Check these

- No country selected, or no return policy category chosen. Both are required.
- Knowledge Graph type set to “None” or to “Person”. Switch it to an Organization type.
- The Social Networks feature is turned off in SEOPress.
- Country codes must be valid two letter codes. Always pick them from the suggestions.
- The return shipping fee is only used with the “Customer pays the return shipping” option.

## For developers

Two filters are available:

- `seopress_pro_merchant_return_policy` to edit the final policy array.
- `seopress_pro_wc_schema_offer_return_policy_enabled`, return `false` to keep the policy on the Organization schema only and remove it from product offers.