Hướng dẫn về MerchantReturnPolicy Schema

MerchantReturnPolicy là đó schema.org loại đó marks lên của bạn trả về policy cho Google — nested dưới Organization hoặc Offer, không bao giờ on của nó own. Ở đây là đó bắt buộc properties, đó applicableCountry so với. returnPolicyCountry confusion, và đó four-way precedence hierarchy đó decides mà policy thực ra cho thấy.

Xuất bản lần đầu: 2 thg 7, 2026 · Cập nhật lần cuối: 8 thg 8, 2026 · Advanced
Ngôn ngữ

MerchantReturnPolicy là đó schema.org loại đó mô tả của bạn trả về policy — window, fees, các phương thức, refund loại — trong machine-readable form. Đó single hầu hết quan trọng điều để nhận right: đây là một nested, thuộc tính-cấp độ loại, không bao giờ một standalone markup. Bạn attach điều này qua hasMerchantReturnPolicy dưới Organization (một site-wide policy) hoặc Offer (một theo-sản phẩm override). Khi bạn dùng điều này, Google requires một of hai options — applicableCountry + returnPolicyCategory, hoặc chỉ merchantReturnLink — và nếu đó category là MerchantReturnFiniteReturnWindow, merchantReturnDays là bắt buộc cũng. Điều này không phải bắt buộc cho baseline Sản phẩm rich kết quả; đây là một được khuyến nghị enhancement đó gates chỉ đó trả về display. Watch hai traps: applicableCountry (nơi đó policy áp dụng) không phải returnPolicyCountry (nơi đó item ships lại để), và một trả về policy có thể là set trong four places — Nội dung API, Merchant Center/Search Console settings, sản phẩm-cấp độ markup, organization-cấp độ markup — đó follow một strict precedence order, với Search Console settings overriding của bạn on-trang markup hoàn toàn.

TL;DR — MerchantReturnPolicy là một nested, thuộc tính-cấp độ loại, không một standalone markup: đây là đó giá trị of hasMerchantReturnPolicy on Organization (site-wide default) hoặc Offer (theo-sản phẩm override). Bắt buộc là một hai-option lựa chọn — applicableCountry + returnPolicyCategory, hoặc merchantReturnLink; và MerchantReturnFiniteReturnWindow làm merchantReturnDays bắt buộc. applicableCountry (nơi đó policy áp dụng) là không returnPolicyCountry (nơi đó item physically ships lại để) — đó conflation là spreading và đây là sai. Điều này là không một base-eligibility requirement cho Sản phẩm rich kết quả — đây là một được khuyến nghị enhancement gating chỉ đó trả về display. Và một trả về policy có thể là được định nghĩa trong four places với một strict precedence order (Nội dung API → Merchant Center/Search Console settings → sản phẩm-cấp độ markup → organization-cấp độ markup), nơi Search Console settings override của bạn on-trang dữ liệu có cấu trúc hoàn toàn.

Evidence for this claim Schema.org MerchantReturnPolicy defines return-policy properties and can be associated with an Organization or Offer. Scope: Schema.org vocabulary. Confidence: high · Verified: Schema.org: MerchantReturnPolicy Evidence for this claim Google supports organization-level and offer-level merchant return policy markup, with offer-level policy taking precedence for that product. Scope: Current Google merchant return policy structured-data behavior and required fields. Confidence: high · Verified: Google Search Central: Merchant return policy structured data

Điều gì điều này thực ra là — một nested loại, không một listing loại

Này là đó mental model mọi thứ khác hangs on. MerchantReturnPolicy là không một schema bạn mark lên on của nó own as đó chính loại of một trang, đó way bạn sẽ Product hoặc JobPosting. đây là một thuộc tính-cấp độ loại: an instance of điều này là đó giá trị of đó hasMerchantReturnPolicy thuộc tính, attached để một of hai parent types.

Google own tài liệu lay out đó hai levels explicitly: “A standard return policy for your business that applies to most or all products you sell can be specified using the MerchantReturnPolicy structured data type nested under the Organization structured data type using the hasMerchantReturnPolicy property. If you need to override your standard return policy for a specific product, specify one or more instances of MerchantReturnPolicy under the Offer type.” (bản dịch) «MỘT tiêu chuẩn trả về policy cho của bạn business đó áp dụng để hầu hết hoặc all các sản phẩm bạn sell có thể là specified dùng đó MerchantReturnPolicy dữ liệu có cấu trúc loại nested dưới đó Organization dữ liệu có cấu trúc loại dùng đó hasMerchantReturnPolicy thuộc tính. Nếu bạn cần để override của bạn tiêu chuẩn trả về policy cho một cụ thể sản phẩm, specify một hoặc hơn instances of MerchantReturnPolicy dưới đó Offer loại.»

So đây là một companion để đó Product/Offer types, không một đối thủ để them. Nếu bạn đã đọc my commerce schema hub — my practitioner label cho đó schema.org listing types (Product, ProductGroup, JobPosting) đó earn của họ own rich kết quả — MerchantReturnPolicy là có chủ ý không trong đó group. Những là đó các trang bạn mark lên; này là một thuộc tính bạn attach để them.

Bắt buộc properties: một hai-option lựa chọn

Khi bạn dùng điều này, Google requires một of hai options — “choose the option that best suits your use case” (bản dịch) «chọn đó option đó best suits của bạn dùng case»:

Option MỘT — structured details:

  • applicableCountry (Text) — “The country code that the return policy applies to (where the product is sold and will be returned from). Use the two-letter ISO 3166-1 alpha-2 country code formatting. You can specify up to 50 countries.” (bản dịch) «Đó country code đó trả về policy áp dụng để (nơi đó sản phẩm là sold và sẽ là đã trả về từ). Dùng đó hai-letter ISO 3166-1 alpha-2 country code formatting. Bạn có thể specify lên để 50 countries.»
  • returnPolicyCategory (MerchantReturnEnumeration) — đó loại of trả về policy, một of three enum các giá trị (dưới).

Option B — chỉ một link:

  • merchantReturnLink (URL) — “Specify the URL of a web page that describes the return policy to your customers. This can be your own return policy, or a third-party policy from a service that handles your returns.” (bản dịch) «Specify đó URL of một web trang đó mô tả đó trả về policy để của bạn customers. Này có thể là của bạn own trả về policy, hoặc một bên thứ ba policy từ một service đó xử lý của bạn trả về.»

Option B là đó escape hatch cho merchants ai không thể giữ detailed markup hiện tại — point tại đó policy trang và là đã xong.

Đó three returnPolicyCategory các giá trị

Straight từ Google tài liệu, những là đó chỉ three hợp lệ các giá trị, và they phải là đó đầy đủ schema.org URL, không đơn giản text như “30 days” (dùng đơn giản text là một of đó hầu hết phổ biến validation các lỗi):

  • https://schema.org/MerchantReturnFiniteReturnWindow“There’s a set number of days to return a product.” (bản dịch) «có một set number of days để trả về một sản phẩm.»
  • https://schema.org/MerchantReturnUnlimitedWindow“There’s an unlimited amount of time to return a product.” (bản dịch) «có an unlimited amount of time để trả về một sản phẩm.»
  • https://schema.org/MerchantReturnNotPermitted“Returns aren’t permitted.” (bản dịch) «Trả về không permitted.»

Khi merchantReturnDays becomes bắt buộc

có một conditional requirement để remember: “If you use MerchantReturnFiniteReturnWindow, then the merchantReturnDays property is required.” (bản dịch) «Nếu bạn dùng MerchantReturnFiniteReturnWindow, thì đó merchantReturnDays thuộc tính là bắt buộc.» So một finite window không có một day count là không hợp lệ — nếu bạn chẳng hạn customers có một set number of days, bạn có để chẳng hạn cách nhiều.

applicableCountry so với. returnPolicyCountry — đó thuộc tính mọi người confuses

Này là worth của nó own section, vì một factual lỗi là actively spreading qua phụ SEO nội dung — including some cao hơn-authority coverage đó được diễn đạt returnPolicyCountry as “now required.” (bản dịch) «hiện tại bắt buộc.» Điều này không. Ở đây đó phân biệt, straight từ đó trực tiếp doc:

  • applicableCountrybắt buộc (as part of Option MỘT) và mô tả nơi đó policy áp dụng — nơi đó sản phẩm là sold và returnable từ.
  • returnPolicyCountryđược khuyến nghị, không bắt buộc, và mô tả điều gì đó khác nhau: “The country where the product has to be sent to for returns. This country can be different from the country where the product was originally shipped or sent to.” (bản dịch) «Đó country nơi đó sản phẩm có để là đã gửi để cho trả về. Này country có thể là khác nhau từ đó country nơi đó sản phẩm đã là originally shipped hoặc đã gửi để.»

Google own ví dụ làm đó khác biệt concrete: "applicableCountry": ["DE", "AT", "CH"], "returnPolicyCountry": "IE" — i.e., đó policy áp dụng để (và các sản phẩm là returnable từ) Germany, Austria, và Switzerland, nhưng đó physical trả về address là trong Ireland. Hai khác nhau concepts, hai khác nhau properties. Nếu một nguồn tells bạn returnPolicyCountry là bắt buộc, kiểm tra điều này so với Google trả về-policy doc — đó bắt buộc trường là applicableCountry.

Được khuyến nghị enrichment properties

Beyond đó bắt buộc minimum, những được khuyến nghị properties làm đó trả về display richer. All là enum-based:

  • returnFees (ReturnFeesEnumeration): FreeReturn, ReturnFeesCustomerResponsibility, hoặc ReturnShippingFees (một merchant-charged shipping fee — specify đó non-zero amount với returnShippingFeesAmount).
  • returnMethod (ReturnMethodEnumeration): ReturnAtKiosk, ReturnByMail, ReturnInStore.
  • refundType (RefundTypeEnumeration): ExchangeRefund, FullRefund, StoreCreditRefund.
  • restockingFee (MonetaryAmount hoặc Number) — một percentage hoặc fixed amount.
  • returnLabelSource (ReturnLabelSourceEnumeration): ReturnLabelCustomerResponsibility, ReturnLabelDownloadAndPrint, ReturnLabelInBox.
  • itemCondition, returnPolicyCountry, và itemDefectReturnShippingFeesAmount round out đó phổ biến set.

Worth knowing: schema.org vocabulary cho MerchantReturnPolicy là lớn hơn này list — điều này cũng defines properties như customerRemorseReturnFees, inStoreReturnsOffered, và validForMemberTier đó không xuất hiện trong Google own trả về-policy doc. Schema.org validity và Google hỗ trợ là hai khác nhau điều. Stick để đó properties Google tài liệu thực ra list nếu của bạn goal là đó trả về rich-kết quả feature — đó rộng hơn vocabulary tồn tại, nhưng Google hasn’t được ghi lại đó điều này đọc điều này.

Seasonal overrides cho holiday windows

Trả về policies thường loosen over đó holidays, và có một thuộc tính cho chính xác đó: returnPolicySeasonalOverride (MerchantReturnPolicySeasonal). Điều này cho phép bạn specify một khác nhau policy cho một date range — của nó own returnPolicyCategory, merchantReturnDays, và startDate/endDate — không có touching của bạn tiêu chuẩn policy. MỘT retailer đang chạy an extended-holiday-trả về window có thể layer đó on top of đó năm-round default.

Organization-cấp độ so với. Offer-cấp độ: mà để dùng

  • Organization-cấp độ (hasMerchantReturnPolicy dưới Organization) là cho của bạn tiêu chuẩn, business-wide policy. Set điều này khi và điều này áp dụng broadly. Này là đó right default đối với hầu hết trang web, và điều này tồn tại cụ thể so bạn không có để repeat đó policy on mỗi sản phẩm trang. Google khuyến nghị dùng một of đó OnlineStore hoặc LocalBusiness subtypes of Organization cho này.
  • Offer-cấp độ (hasMerchantReturnPolicy dưới Offer) là chỉ cho genuine exceptions — một cụ thể sản phẩm whose trả về terms differ từ của bạn tiêu chuẩn.

Và một caution từ đó precedence rules dưới: sản phẩm-cấp độ (Offer) markup luôn wins over organization-cấp độ, so một stale hoặc incorrect Offer-cấp độ override sẽ silently beat một correct organization-cấp độ default. không sprinkle Offer-cấp độ policies “để là safe.”

Là MerchantReturnPolicy bắt buộc cho Sản phẩm rich kết quả?

Không — và này là đó myth hầu hết worth busting. Google Sản phẩm intro doc lists điều này as một được khuyến nghị enhancement, không một base-eligibility requirement: “In addition to structured data for the individual products that you sell, we also recommend you add structured data defining the policies of your ecommerce business, nested under Organization markup: Merchant return policy: Specify the return policy (or policies) for your business.” (bản dịch) «Ngoài ra để dữ liệu có cấu trúc cho đó riêng lẻ các sản phẩm đó bạn sell, we cũng khuyến nghị bạn thêm dữ liệu có cấu trúc defining đó policies of của bạn ecommerce business, nested dưới Organization markup: Merchant trả về policy: Specify đó trả về policy (hoặc policies) cho của bạn business.» On đó merchant-listing doc, hasMerchantReturnPolicy là một được khuyến nghị thuộc tính of Offer, không một of đó bắt buộc properties (như pricepriceCurrency) đó gate baseline eligibility.

Evidence for this claim Google supports organization-level and offer-level merchant return policy markup, with offer-level policy taking precedence for that product. Scope: Current Google merchant return policy structured-data behavior and required fields. Confidence: high · Verified: Google Search Central: Merchant return policy structured data

Translation: omitting trả về-policy markup không disqualify một trang từ sản phẩm snippets hoặc merchant listings. Điều này chỉ có nghĩa là đó trả về enhancement sẽ không cho thấy. đây là an thêm-on, không an entry ticket. Và theo đó rộng hơn dữ liệu có cấu trúc hub, none of điều này là một xếp hạng factor — điều này earns eligibility cho an appearance, không position.

đây là cũng worth đang precise về điều gì “correct markup” (bản dịch) «correct markup» thực ra proves. Hợp lệ schema.org syntax, Google-được ghi lại hỗ trợ cho một thuộc tính, syntactically hợp lệ JSON-LD, rich-kết quả eligibility, và đó policy thực ra displaying trong Tìm kiếm là five tách biệt trạng thái — passing một không bảo đảm đó tiếp theo. Và none of them là một tín hiệu xếp hạng, một legal compliance bảo đảm, hoặc một promise đó an AI shopping surface sẽ đọc hoặc honor đó policy đó way Tìm kiếm làm — Google tài liệu không claim bất kỳ of đó.

Đó precedence hierarchy — đó real differentiator

Ở đây đó part gần như không competing hướng dẫn giải thích rõ ràng. MỘT trả về policy có thể là được định nghĩa trong four khác nhau places, và khi hơn một tồn tại, chỉ một wins. Google trạng thái đó order of precedence, “from strongest to weakest” (bản dịch) «từ strongest để weakest»:

  1. Nội dung API cho Shopping (trả về settings)
  2. Settings trong Merchant Center hoặc Search Console
  3. Sản phẩm-cấp độ merchant listing markup (Offer)
  4. Organization-cấp độ markup

I re-verified này chính xác order so với Google trực tiếp doc trong July 2026, và điều này hasn’t changed since đó November 2025 cập nhật dưới — nhưng này là một doc family đó moves, so re-kiểm tra điều này so với đó trực tiếp trang thay vì trusting bất kỳ snapshot, including này một, indefinitely.

Google says điều này plainly: “if you provide both return policy markup on your site and return policy settings in Search Console, Google will only use the information provided in Search Console.” (bản dịch) «nếu bạn cung cấp cả hai trả về policy markup trên trang web của bạn và trả về policy settings trong Search Console, Google sẽ chỉ dùng đó information provided trong Search Console.» So của bạn on-trang dữ liệu có cấu trúc sits tại đó bottom of đó stack — một Merchant Center hoặc Search Console setting silently overrides điều này. Này là đó single hầu hết phổ biến nguồn of “my markup is perfect but the wrong policy shows” (bản dịch) «my markup là perfect nhưng đó sai policy cho thấy» confusion, và đây là vì sao đó đầu tiên điều để kiểm tra khi một displayed policy disagrees với của bạn code là liệu điều gì đó set trong Search Console hoặc Merchant Center.

Làm bạn ngay cả cần markup? Merchant Center và Search Console alternatives

Google là upfront đó markup không đó chỉ path, và thường không đó best một: “Retailer return policies can get complicated and may change frequently. If you’re having trouble indicating and keeping your return details up-to-date with markup and have a Google Merchant Center account, consider configuring your return policies in Google Merchant Center. You can alternatively configure account-level return policies in Search Console, which get automatically added to Merchant Center.” (bản dịch) «Retailer trả về policies có thể nhận complicated và có thể thay đổi frequently. Nếu bạn là có trouble indicating và giữ của bạn trả về details lên-để-date với markup và có một Google Merchant Center account, consider configuring của bạn trả về policies trong Google Merchant Center. Bạn có thể alternatively configure account-cấp độ trả về policies trong Search Console, mà nhận tự động đã thêm để Merchant Center.»

So đó decision là genuinely three-way: markup (Organization hoặc Offer), Merchant Center settings, hoặc Search Console settings. Nếu bạn đã có một Merchant Center account, Google khuyến nghị configuring trả về ở đó thay vì trong markup — đây là easier để giữ hiện tại, và điều này outranks markup anyway.

Gần đây thay đổi: đó 2024–2025 timeline

Này doc family moves fast, so đó history matters:

  • 2023 — Google enabled trả về-policy dữ liệu có cấu trúc cho riêng lẻ các sản phẩm (Offer-cấp độ) — đó starting point, theo Google own sau đó cách diễn đạt.
  • June 11, 2024 — Google đã thêm organization-cấp độ hasMerchantReturnPolicy hỗ trợ, so bạn có thể set một business-wide policy thay vì repeating điều này theo sản phẩm. Đó Google Shopping engineers ai announced điều này (Irina Tuduce, Pascal Fleury, và Johan Linder) được diễn đạt điều này khoảng merchants không có một Merchant Center account: “Adding a return policy to your organization structured data is especially important if you don’t have a Merchant Center account and want the ability to provide a return policy for your business.” (bản dịch) «Thêm một trả về policy để của bạn organization dữ liệu có cấu trúc là especially quan trọng nếu bạn không có một Merchant Center account và muốn đó ability để cung cấp một trả về policy cho của bạn business.»
  • November 12, 2025 — Google expanded đó Search Console “Shipping and returns” (bản dịch) «Shipping và trả về» feature để all websites identified as online merchants (previously điều này bắt buộc một Merchant Center account), và đã thêm organization-cấp độ shipping policy markup. Của họ note on precedence là worth pinning để đó fridge: “It’s important to note that settings configured in Search Console will take precedence over structured data on your site.” (bản dịch) «đây là quan trọng để note đó settings configured trong Search Console sẽ take precedence over dữ liệu có cấu trúc trên trang web của bạn.»

Một clarification on đó November 2025 cập nhật: đó new shipping policy markup là một tách biệt loại từ MerchantReturnPolicy — không conflate trả về và shipping. Shipping policy là của nó own structured-dữ liệu path (một ShippingService-style loại). Này bài viết là về trả về; shipping là một sibling topic.

Cách Bing xử lý này — spoiler, điều này không (cụ thể)

Là honest về đó asymmetry. Bing Quản trị viên web Tools validate schema.org markup generically và Bing đọc dữ liệu có cấu trúc, nhưng Bing publishes không MerchantReturnPolicy-cụ thể bắt buộc/được khuyến nghị thuộc tính bảng, không dedicated trả về rich-kết quả feature, và không tương đương để Google shopping knowledge-panel trả về display. Bing ecommerce hướng dẫn lives trong của nó Shopping-quảng cáo feed specs, không trong schema.org trả về markup. Này mirrors đó giống nhau pattern I noted cho Product, ProductGroup, và JobPosting trong đó commerce hub: Bing validates generically; Google xây dựng dedicated features on top. So implement trả về markup cho Google — và không expect một parallel Bing feature.

Các lỗi thường gặp và Search Console warnings

Đó recurring ones:

  • Đơn giản-text enum các giá trị. returnPolicyCategory phải được đó đầy đủ https://schema.org/... URL, không “30 days” hoặc “finite.” Giống nhau cho returnFees, returnMethod, và refundType.
  • Finite window với không day count. MerchantReturnFiniteReturnWindow không có merchantReturnDays là không hợp lệ.
  • Confusing applicableCountry với returnPolicyCountry (see trên).
  • “Missing field hasMerchantReturnPolicy (in offers).” (bản dịch) «Bị thiếu trường hasMerchantReturnPolicy (trong offers).» Này Search Console warning có nghĩa là đó trả về enhancement là không khả dụng vì đó thuộc tính là absent — nhưng map điều này để đó precedence hierarchy trước khi bạn panic-thêm markup: nếu bạn đã set trả về trong Search Console hoặc Merchant Center, đó là điều gì cho thấy anyway, và đó markup warning có thể là moot.
  • Markup/visible-nội dung mismatch. As với all dữ liệu có cấu trúc, đó policy trong của bạn markup nên match điều gì là thực ra on đó trang.
  • Repeating trả về markup on mỗi sản phẩm trang khi an Organization-cấp độ policy sẽ cover them all — đó entire point of đó 2024 launch.

Nơi này fits

MerchantReturnPolicy là một companion deep-dive để đó commerce schema hub (Sản phẩm, ProductGroup, JobPosting) — đây là đó thuộc tính-cấp độ loại bạn attach để OfferOrganization, không một fourth listing loại. Điều này sits bên trong đó rộng hơn dữ liệu có cấu trúc cho SEO subcluster alongside schema markup, JSON-LD, và rich kết quả, mà trong turn lives trong đó on-trang SEO cluster. Shipping-policy markup — đó sibling đó shipped alongside đó November 2025 cập nhật — là một tách biệt loại worth của nó own treatment.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.