Google return policy schema

How to Set Up MerchantReturnPolicy Structured Data for an Online Store in 2026

MerchantReturnPolicy structured data allows online retailers to explain their returns policies to Google in a format search engines can interpret. It covers essential information such as return deadlines, refund options, shipping fees and accepted return methods. In 2026, properly configured markup can help Google display relevant return conditions in shopping-related search results and merchant knowledge panels. However, adding this information requires more than installing an SEO extension or inserting a few properties into a website. Retailers need to understand Google’s requirements, select the correct schema values and ensure that every detail matches their actual returns policy. This guide explains how to configure MerchantReturnPolicy correctly, manage exceptions and avoid implementation errors that could affect visibility in Google Search.

What Is MerchantReturnPolicy Structured Data and Why Does It Matter?

MerchantReturnPolicy is a structured data type developed within Schema.org to describe how a business handles product returns. It provides search engines with clearly defined information about the period during which purchases can be returned, whether customers must pay return shipping charges and which refund methods are available. For example, an online clothing retailer offering free returns within 30 days can communicate both conditions through structured data. Google can then interpret these details without relying solely on the written policy. The information may appear alongside eligible products in search results, helping shoppers understand important purchasing conditions before opening a product page.

Google supports MerchantReturnPolicy at two levels: the organisation and the individual product offer. Organisation-level markup describes the general policy applying to most or all products sold by a retailer. It is placed within Organization structured data using the hasMerchantReturnPolicy property. Product-level markup is used when particular products have different return conditions. For instance, a furniture shop may offer a standard 30-day return period but provide 60 days for selected products. Google recommends defining the general policy at organisation level and using product-specific markup only for exceptions or where no standard policy exists. This reduces unnecessary duplication and makes large product catalogues easier to maintain.

Accurate return information can improve the shopping experience by helping customers assess potential costs and restrictions before purchasing. A buyer comparing two retailers may consider return shipping charges or refund periods alongside price and delivery speed. However, MerchantReturnPolicy is not a direct ranking factor, and valid markup does not guarantee enhanced search appearances. Google determines when and where return information is displayed, considering eligibility requirements and information supplied through other merchant settings. Retailers should therefore prioritise accuracy rather than treating the markup as an SEO shortcut. Its primary purpose is to make commercial conditions understandable, consistent and accessible to search engines.

Which MerchantReturnPolicy Properties Are Required in 2026?

Google provides two options for configuring a standard organisation-level return policy. The first uses applicableCountry and returnPolicyCategory, together with merchantReturnDays when the policy specifies a fixed return window. The applicableCountry property identifies the countries where the policy applies using two-letter ISO country codes, such as GB for the United Kingdom, DE for Germany and FR for France. Google supports up to 50 countries within this property. The returnPolicyCategory property defines whether returns are accepted within a specified period, accepted without a fixed deadline or not permitted. The second organisation-level option uses merchantReturnLink to identify the retailer’s published policy page. For more detailed return information, the first approach provides greater control over the conditions communicated to Google.

Three values are available for returnPolicyCategory: MerchantReturnFiniteReturnWindow, MerchantReturnUnlimitedWindow and MerchantReturnNotPermitted. The first describes a fixed return period and requires merchantReturnDays to contain an integer. For example, a retailer allowing returns within 30 days of delivery would specify MerchantReturnFiniteReturnWindow and set merchantReturnDays to 30. MerchantReturnUnlimitedWindow indicates that no fixed deadline applies, while MerchantReturnNotPermitted describes products for which returns are not accepted under the stated policy. Retailers must be careful with the last option because consumer protection legislation may still provide cancellation, refund or remedy rights. The category must represent the actual arrangements without suggesting that mandatory legal protections have been removed.

Additional properties provide more detailed information about return conditions. The returnMethod property identifies whether purchases can be returned by post, in a physical shop or at a designated kiosk. The returnFees property explains who covers return costs, while refundType describes available outcomes such as a full refund, exchange or store credit. Other supported organisation-level properties include itemCondition, returnPolicyCountry, returnLabelSource and restockingFee. Stores may also distinguish return charges for defective products from those associated with a customer’s change of mind. These details are recommended where relevant rather than universally mandatory. Retailers should include properties that accurately reflect their procedures and avoid supplying values for services or options they do not offer.

How to Configure MerchantReturnPolicy for an Online Store

Before implementing structured data, retailers should review their existing return conditions and identify which rules apply across the catalogue. The review should establish the permitted return period, accepted item conditions, available return methods, refund arrangements and responsibility for postage charges. Consider a UK clothing retailer offering 30-day returns from delivery, free return shipping and full refunds to the original payment method. Its markup would identify GB as the applicable country, MerchantReturnFiniteReturnWindow as the policy category, 30 as merchantReturnDays, ReturnByMail as the return method and FreeReturn as the fee type. These settings describe an illustrative commercial policy rather than a standard arrangement required for all British businesses.

Google recommends JSON-LD as a practical format for structured data because it can be managed separately from the visible content. The MerchantReturnPolicy object should be nested within the retailer’s Organization or OnlineStore structured data through hasMerchantReturnPolicy. Every property must use the correct data type and supported vocabulary value. Country identifiers should follow the two-letter ISO format, return deadlines should be expressed as integers and monetary amounts should contain a valid currency. Where Schema.org enumeration values are required, their recognised machine-readable identifiers must be used in the generated markup rather than ordinary descriptions. A developer or compatible structured data tool can handle this syntax while allowing store administrators to manage the underlying business information.

Google recommends placing the general MerchantReturnPolicy markup on a single page describing the retailer’s returns policy rather than repeating it across every product page. The page should explain the same conditions that appear in the structured data and remain accessible to customers. For WordPress and WooCommerce websites, implementation depends on the active theme, SEO extensions and existing structured data output. Some tools support return policy properties directly, while others require additional configuration or development. Before adding anything, inspect whether Organization and Product markup is already generated automatically. Extending an existing configuration is generally preferable to producing duplicate objects that describe the same business differently.

How to Set Return Windows, Fees and Product-Specific Exceptions

Return shipping charges require particular attention because Google distinguishes three different arrangements. FreeReturn means the customer pays nothing to return the product. ReturnFeesCustomerResponsibility applies when the customer independently arranges and pays for return shipping. ReturnShippingFees indicates that the retailer charges a specified amount for the return. When ReturnShippingFees is selected, returnShippingFeesAmount must provide the non-zero fee and its currency. For example, a retailer charging £4.95 for prepaid return shipping would describe that amount using MonetaryAmount with GBP as the currency. The amount must not be included when FreeReturn or ReturnFeesCustomerResponsibility is selected. Incorrect fee combinations can cause validation problems or communicate misleading information about return costs.

Product-specific return rules can be added within the Offer structured data of an individual Product. This is useful when a retailer provides a different return window for selected items or operates product categories with distinct return arrangements. The Offer-level MerchantReturnPolicy supports applicableCountry, returnPolicyCategory, merchantReturnDays, returnMethod, returnFees and the relevant return shipping amount. It does not support every property available at organisation level. When Google receives both general and product-specific return policy markup, the product-level policy takes precedence for that offer. Retailers should therefore avoid adding separate rules to products that follow the standard conditions, as unnecessary overrides make inconsistencies more likely.

International retailers should configure returns according to the countries where purchases are made and the locations where goods must be sent. The applicableCountry property identifies the market covered by the policy, while returnPolicyCountry identifies the country receiving returned products. A German retailer selling to customers in France may use FR as the applicable country and DE as the return destination when returns are processed in Germany. Several countries can share one policy if their conditions genuinely match. Separate descriptions are appropriate where return windows, shipping charges or procedures differ. Retailers must also consider local legislation. For example, qualifying distance purchases in the UK and EU generally carry statutory 14-day cancellation or withdrawal rights, subject to exceptions and specific procedures. Voluntary store policies should never be presented as replacing those rights.

Google return policy schema

How to Test MerchantReturnPolicy and Avoid SEO Implementation Errors

Once MerchantReturnPolicy has been added, the next step is to confirm that Google can interpret the generated structured data. Google’s Rich Results Test can inspect a published page or a supplied code sample and identify issues affecting supported search enhancements. Retailers should test their main returns policy page and any product pages containing special return conditions. The test should confirm that MerchantReturnPolicy is associated with the correct Organization or Offer object and that required properties are present. For a fixed return period, merchantReturnDays must be a valid integer. Country codes, return categories and shipping fee properties should also be checked. The Schema Markup Validator can provide an additional check of Schema.org structure, although general schema validity does not guarantee eligibility for Google’s shopping features.

One of the most common implementation problems is disagreement between the markup and the actual returns policy. A shop might advertise 30-day returns on its website while structured data still specifies 14 days. Another might describe returns as free even though customers must pay for postage. Problems can also arise when a WooCommerce extension automatically generates return information that conflicts with custom markup. Because product-level MerchantReturnPolicy can override the organisation-level policy, outdated product exceptions are especially important to identify. Retailers should examine the final structured data generated by their website rather than relying exclusively on what appears inside an extension’s settings. Correct configuration means the resulting information is accurate, not merely that a testing tool reports no errors.

Google Merchant Center and Search Console introduce another consideration because return settings may be supplied independently of website markup. Google’s precedence rules give priority to product-level information submitted through Merchant Center feeds, followed by applicable account settings in Merchant Center or Search Console, product-level structured data and organisation-level structured data. Consequently, changes made exclusively to MerchantReturnPolicy may not affect the information Google uses when a higher-priority source contains different conditions. Online retailers should compare their product feeds, merchant account settings and website policies whenever updating returns arrangements. Consistent information across these sources helps prevent outdated charges or deadlines from appearing in shopping-related search experiences.

How to Maintain MerchantReturnPolicy and Monitor Results in 2026

After implementation, Google Search Console can help identify structured data problems affecting merchant listings. The Merchant listings report highlights relevant issues on eligible product pages, while other diagnostic reports may reveal invalid or unparseable markup. Retailers should examine reported errors, correct the underlying issue and use the available validation process to request confirmation after changes. Google’s systems still need time to recrawl and process updated pages, so improvements may not appear immediately. Even technically valid MerchantReturnPolicy markup does not guarantee that Google will display return information in every result. The appearance of these details depends on the search feature, eligibility, available merchant information and Google’s presentation decisions.

Returns policy markup should be reviewed whenever business arrangements change. Important triggers include extending the standard return window, introducing new delivery countries, changing return postage charges, updating refund methods or relocating a returns warehouse. Seasonal promotions also require attention. A retailer extending its return deadline for Christmas purchases can describe qualifying arrangements using returnPolicySeasonalOverride within organisation-level markup. The seasonal configuration should reflect the actual purchase period and applicable return deadline rather than an estimated promotion. When the temporary conditions expire, the standard policy must remain accurate. WordPress and WooCommerce stores should additionally test their markup after significant theme changes, structured data extension updates or major alterations to checkout and product management functionality.

A reliable MerchantReturnPolicy configuration depends on keeping customer-facing policies, structured data and Google merchant settings consistent. Retailers should maintain a clear written returns policy, use organisation-level markup for standard arrangements and introduce product-specific exceptions only when necessary. Return deadlines, shipping charges, refund options and international conditions must accurately represent what customers can expect. Regular validation helps identify missing properties and outdated information, but it cannot replace a review of the actual commercial rules. In 2026, the most effective approach is to treat MerchantReturnPolicy as a maintained part of an online store’s product information rather than a one-time SEO adjustment. Accurate structured data supports clearer shopping information while reducing the risk of conflicting return conditions appearing across Google’s services.