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.
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.
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 dataTL;DR — MerchantReturnPolicy là một bit of code đó tells Google của bạn trả về policy — cách nhiều days customers có để trả về điều gì đó, ai pays trả về shipping, và điều gì refund they nhận. Bạn không put điều này on một trang by itself; bạn attach điều này để của bạn business (
Organization) hoặc để một cụ thể sản phẩm (Offer) dùng một thuộc tính calledhasMerchantReturnPolicy. Điều này có thể làm của bạn trả về details cho thấy lên right trong kết quả tìm kiếm, nhưng điều này không bắt buộc để nhận một sản phẩm listing, và điều này sẽ không làm bạn xếp hạng cao hơn.
Điều gì điều này là
Khi shoppers là deciding liệu để buy, đó trả về policy là một of đó đầu tiên điều they kiểm tra. MerchantReturnPolicy là dữ liệu có cấu trúc — một nhỏ block of machine-readable code — đó spells out của bạn trả về policy so Google có thể đọc điều này: đó trả về window, đó fees, cách customers trả về điều, và điều gì refund they nhận. Khi Google có thể đọc điều này rõ ràng, điều này có thể cho thấy đó information right trong đó sản phẩm tìm kiếm listing và trong knowledge panels, so mọi người không có để nhấp qua để một policy trang để tìm out.
đây là part of đó rộng hơn dữ liệu có cấu trúc family (đó schema.org vocabulary,
thường được viết trong một format called JSON-LD). Nếu bạn đã đọc về Product hoặc
Offer schema cho ecommerce các trang, này là đó piece đó mô tả trả về.
Đó một điều để understand đầu tiên
MerchantReturnPolicy là không bao giờ marked lên on của nó own. đây là không một trang loại như
Product. Thay vì, bạn nest điều này bên trong điều gì đó khác dùng một thuộc tính called
hasMerchantReturnPolicy, và bạn có hai choices cho nơi:
- Dưới
Organization— một tiêu chuẩn trả về policy cho của bạn toàn bộ business, set khi, applied để hầu hết hoặc all các sản phẩm. Này là đó easy path đối với hầu hết trang web. - Dưới
Offer— một trả về policy cho một cụ thể sản phẩm, dùng chỉ khi đó sản phẩm policy là khác nhau từ của bạn tiêu chuẩn một.
Think of điều này as an thuộc tính of của bạn business hoặc một sản phẩm, không một trang trong của nó own right.
Điều gì bạn có để bao gồm
Khi bạn decide để dùng điều này, Google cho bạn hai options cho đó bắt buộc information — pick whichever fits:
- Option MỘT: đó country đó policy áp dụng để (
applicableCountry) plus đó loại of policy (returnPolicyCategory— basically “you have X days,” (bản dịch) «bạn có X days,» “unlimited time,” (bản dịch) «unlimited time,» hoặc “không trả về”). Nếu bạn chẳng hạn “X days,” bạn cũng có để chẳng hạn cách nhiều (merchantReturnDays). - Option B: chỉ một link để của bạn trả về-policy trang (
merchantReturnLink).
Option B là đó simplest — nếu giữ detailed markup hiện tại sounds như một chore, một link để của bạn policy trang là một hợp lệ way để làm điều này.
Điều gì hầu hết mọi người nhận sai
Bạn không cần này để nhận một sản phẩm listing trong Google. Some các hướng dẫn frame trả về-policy markup as một 2026 “requirement” cho sản phẩm rich kết quả. Điều này không — đây là một được khuyến nghị enhancement. Skipping điều này không disqualify của bạn sản phẩm từ appearing; điều này chỉ có nghĩa là đó trả về detail sẽ không cho thấy. Như all dữ liệu có cấu trúc, điều này không làm bạn xếp hạng cao hơn either.
Và ở đây đó sneaky part: nếu bạn cũng set một trả về policy trong Google Merchant Center hoặc Search Console, những settings win over đó code on trang của bạn. Bạn có thể có flawless markup và vẫn see một khác nhau policy displayed. Hơn on đó trong đó Advanced tab.
Muốn đó đầy đủ picture — đó chính xác thuộc tính list, đó applicableCountry so với.
returnPolicyCountry trap, seasonal overrides, và đó four-way precedence
hierarchy đó decides mà policy thực ra cho thấy? Chuyển để đó Advanced tab.
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 dataTL;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
hasMerchantReturnPolicyonOrganization(site-wide default) hoặcOffer(theo-sản phẩm override). Bắt buộc là một hai-option lựa chọn —applicableCountry+returnPolicyCategory, hoặcmerchantReturnLink; vàMerchantReturnFiniteReturnWindowlàmmerchantReturnDaysbắt buộc.applicableCountry(nơi đó policy áp dụng) là khôngreturnPolicyCountry(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.
Đ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:
applicableCountrylà bắ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ừ.returnPolicyCountrylà đượ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ặcReturnShippingFees(một merchant-charged shipping fee — specify đó non-zero amount vớireturnShippingFeesAmount).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àitemDefectReturnShippingFeesAmountround 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 độ (
hasMerchantReturnPolicydướiOrganization) 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 đóOnlineStorehoặcLocalBusinesssubtypes ofOrganizationcho này. - Offer-cấp độ (
hasMerchantReturnPolicydướiOffer) 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ư price
và priceCurrency) đó gate baseline eligibility.
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»:
- Nội dung API cho Shopping (trả về settings)
- Settings trong Merchant Center hoặc Search Console
- Sản phẩm-cấp độ merchant listing markup (Offer)
- 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 độ
hasMerchantReturnPolicyhỗ 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ị.
returnPolicyCategoryphải được đó đầy đủhttps://schema.org/...URL, không “30 days” hoặc “finite.” Giống nhau choreturnFees,returnMethod, vàrefundType. - Finite window với không day count.
MerchantReturnFiniteReturnWindowkhông cómerchantReturnDayslà không hợp lệ. - Confusing
applicableCountryvớireturnPolicyCountry(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 để Offer và
Organization, 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.
AI summary
MỘT condensed take on đó Advanced version:
- đây là một nested, thuộc tính-cấp độ loại, không một standalone markup.
MerchantReturnPolicy là đó giá trị of
hasMerchantReturnPolicyonOrganization(một site-wide policy) hoặcOffer(một theo-sản phẩm override). đây là một companion đểProduct/Offer, không một fourth listing loại như Sản phẩm/ProductGroup/JobPosting. - Bắt buộc là một hai-option lựa chọn:
applicableCountry+returnPolicyCategory, hoặc chỉmerchantReturnLink. NếureturnPolicyCategorylàMerchantReturnFiniteReturnWindow, thìmerchantReturnDayslà bắt buộc cũng. - Three
returnPolicyCategoryenum các giá trị: FiniteReturnWindow (set number of days), UnlimitedWindow, NotPermitted — luôn đó đầy đủ schema.org URL, không bao giờ đơn giản text. applicableCountry≠returnPolicyCountry. Đó đầu tiên (bắt buộc) là nơi đó policy áp dụng / sản phẩm là sold và returnable từ; đó second (được khuyến nghị) là nơi đó item physically ships lại để. Phụ sources conflate them — đó trực tiếp doc không.- Không 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 — omitting điều này không disqualify một trang từ sản phẩm snippets hoặc merchant listings. Không phải là yếu tố xếp hạng either.
- Precedence, strongest → weakest: Nội dung API cho Shopping → Merchant Center/Search Console settings → sản phẩm-cấp độ (Offer) markup → organization-cấp độ markup. Search Console settings override của bạn on-trang markup hoàn toàn.
- Được khuyến nghị enrichment:
returnFees,returnMethod,refundType,restockingFee,returnLabelSource, plus seasonal overrides (returnPolicySeasonalOverride) cho holiday windows. Schema.org vocabulary là rộng hơn này (e.g.customerRemorseReturnFees,validForMemberTier) — stick để properties Google own tài liệu list nếu đó goal là đó Tìm kiếm enhancement. - Five tách biệt trạng thái, không một: hợp lệ schema.org syntax, Google-được ghi lại thuộc tính hỗ trợ, hợp lệ JSON-LD, rich-kết quả eligibility, và thực tế display trong Tìm kiếm không bảo đảm mỗi other. 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 honors đó policy.
- Timeline: Offer-cấp độ (2023) → organization-cấp độ launch (June 2024) → Tìm kiếm Console “Shipping and returns” (bản dịch) «Shipping và trả về» opened để all identified merchants + org-cấp độ shipping markup (Nov 2025). Đó new shipping markup là một tách biệt loại từ trả về.
- Bing: validates schema generically nhưng có không MerchantReturnPolicy-cụ thể feature hoặc thuộc tính bảng.
Tài liệu chính thức
Chính-nguồn tài liệu từ Google và schema.org.
- Merchant Trả về Policy (MerchantReturnPolicy) Dữ liệu có cấu trúc — đó canonical reference: bắt buộc/được khuyến nghị properties, đó three
returnPolicyCategoryenums, seasonal overrides, và đó precedence hierarchy. - Introduction để Sản phẩm Dữ liệu có cấu trúc — nơi trả về policy sits as một được khuyến nghị enhancement, không một base-eligibility requirement.
- Cách Thêm Merchant Listing Dữ liệu có cấu trúc —
hasMerchantReturnPolicyas một được khuyến nghịOfferthuộc tính. - Thêm markup hỗ trợ cho organization-cấp độ trả về policies (blog, June 11, 2024) — đó org-cấp độ launch, by Google Shopping engineers Irina Tuduce, Pascal Fleury, và Johan Linder.
- Hơn ways để share của bạn shipping và trả về policies với Google (blog, Nov 12, 2025) — Search Console “Shipping and returns” (bản dịch) «Shipping và trả về» opened để all identified online merchants; precedence restated.
- Set lên của bạn trả về policies cho Shopping quảng cáo và danh sách miễn phí (Merchant Center Help) — đó non-markup alternative.
schema.org
- schema.org/MerchantReturnPolicy — đó vocabulary definition và đầy đủ thuộc tính list.
- schema.org/hasMerchantReturnPolicy — đó thuộc tính đó nests điều này dưới Organization / Sản phẩm / Offer.
Bing / Microsoft
- Marking Lên Trang web của bạn với Dữ liệu có cấu trúc — Bing Quản trị viên web Help — generic schema.org hỗ trợ; note có không MerchantReturnPolicy-cụ thể spec hoặc feature.
Quotes từ đó nguồn
On-đó-record statements từ Google. Mỗi link là một deep link đó jumps để đó quoted passage on đó trang nguồn.
Google — đó hai implementation levels
- “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.» — Google Search Central tài liệu. Nhảy đến trích dẫn
Google — đó bắt buộc hai-option lựa chọn
- “applicableCountry … 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) «applicableCountry … Đó 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.» Nhảy đến trích dẫn
- “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.» Nhảy đến trích dẫn
Google — applicableCountry so với. returnPolicyCountry
- “returnPolicyCountry … 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) «returnPolicyCountry … Đó 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 để.» Nhảy đến trích dẫn
Google — đó precedence hierarchy (đó độ chính xác spine)
- “Google uses the following order of precedence (from strongest to weakest): Content API for Shopping (return settings), Settings in Merchant Center or Search Console, Product-level merchant listing markup, Organization-level markup.” (bản dịch) «Google dùng đó sau order of precedence (từ strongest để weakest): Nội dung API cho Shopping (trả về settings), Settings trong Merchant Center hoặc Search Console, Sản phẩm-cấp độ merchant listing markup, Organization-cấp độ markup.» Nhảy đến trích dẫn
- “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.” (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.» Nhảy đến trích dẫn
Google — đó single-trang khuyến nghị
- “We recommend placing return information on a single page on your site that describes the return policy of your business. You don’t need to include it on every page of your site.” (bản dịch) «We khuyến nghị placing trả về information on một single trang trên trang web của bạn đó mô tả đó trả về policy of của bạn business. Bạn không cần để bao gồm điều này on mỗi trang of trang web của bạn.» Nhảy đến trích dẫn
Google Shopping engineering team (Irina Tuduce, Pascal Fleury, Johan Linder) — đó June 2024 organization-cấp độ launch
- “A return policy is a major factor considered by shoppers when buying products online, and so last year we enabled the extraction of structured data return policies for individual products. Today we’re adding support for return policies at the organization level as well.” (bản dịch) «MỘT trả về policy là một major factor considered by shoppers khi buying các sản phẩm online, và so cuối cùng năm we enabled đó extraction of dữ liệu có cấu trúc trả về policies cho riêng lẻ các sản phẩm. Hôm nay chúng ta là thêm hỗ trợ cho trả về policies tại đó organization cấp độ as well.» Nhảy đến trích dẫn
- “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.» Nhảy đến trích dẫn
Google — đó November 2025 expansion
- “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.» Nhảy đến trích dẫn
Nơi nên I define my trả về policy?
Đó genuinely confusing part of này topic không đó thuộc tính names — đây là đó một trả về policy có thể trực tiếp trong four places đó override mỗi other. Câu trả lời cho của bạn situation và bạn’ll land on đó right phương thức (và tránh đó “my markup is perfect but the wrong policy shows” (bản dịch) «my markup là perfect nhưng đó sai policy cho thấy» trap).
Pick the right place to define your return policy
MerchantReturnPolicy — bảng tra nhanh
Nơi điều này attaches (đây là không bao giờ standalone)
| Cấp độ | Thuộc tính | Dùng điều này cho |
|---|---|---|
Organization | hasMerchantReturnPolicy | Một tiêu chuẩn, site-wide policy (đó default) |
Offer | hasMerchantReturnPolicy | MỘT theo-sản phẩm override — genuine exceptions chỉ |
Bắt buộc — pick một option
| Option | Properties |
|---|---|
| MỘT | applicableCountry (lên để 50 ISO alpha-2 codes) + returnPolicyCategory |
| B | merchantReturnLink (URL để một policy trang) |
Plus đó conditional: MerchantReturnFiniteReturnWindow → merchantReturnDays
bắt buộc.
Đó three returnPolicyCategory các giá trị (đầy đủ schema.org URL, không bao giờ đơn giản text)
| Giá trị | Meaning |
|---|---|
MerchantReturnFiniteReturnWindow | MỘT set number of days |
MerchantReturnUnlimitedWindow | Unlimited time |
MerchantReturnNotPermitted | Không trả về |
Hai properties mọi người confuse
| Thuộc tính | Bắt buộc? | Có nghĩa là |
|---|---|---|
applicableCountry | Có (Option MỘT) | Nơi đó policy áp dụng / sản phẩm là sold và returnable từ |
returnPolicyCountry | Không (được khuyến nghị) | Nơi đó item physically ships lại để |
Precedence — strongest để weakest (chỉ một wins)
- Nội dung API cho Shopping (trả về settings)
- Merchant Center / Search Console settings ← những override của bạn markup
- Sản phẩm-cấp độ (
Offer) markup - Organization-cấp độ markup
Fast facts
- Không bắt buộc cho baseline Sản phẩm rich kết quả — đây là một được khuyến nghị enhancement gating chỉ đó trả về display. Không phải là yếu tố xếp hạng.
- Được khuyến nghị enrichment:
returnFees,returnMethod,refundType,restockingFee,returnLabelSource. - Holiday windows:
returnPolicySeasonalOverride. - Org-cấp độ launched June 2024; Search Console “Shipping and returns” (bản dịch) «Shipping và trả về» opened để all identified merchants Nov 2025.
- Bing: validates generically, không dedicated trả về feature.
- Shipping-policy markup là một tách biệt loại — không conflate với trả về.
Trả về-policy markup mistakes
- Xuất bản
MerchantReturnPolicyas một standalone entity. Attach điều này quahasMerchantReturnPolicyonOrganizationhoặcOffer. - Confusing
applicableCountryvớireturnPolicyCountry. Đó đầu tiên says nơi đó policy áp dụng; đó second says nơi an item là đã gửi lại. - Omitting
merchantReturnDayscho một finite window. Thêm điều này khireturnPolicyCategorydeclares một finite trả về period. - Letting markup contradict Merchant Center hoặc Search Console settings. Audit all policy sources và của họ precedence trước thay đổi một layer.
- Marking lên một policy người dùng không thể tìm. Dữ liệu có cấu trúc phải agree với visible, hiện tại trả về terms và đó linked policy trang.
MerchantReturnPolicy implementation checklist
- Decide liệu đó policy là organization-wide hoặc an offer-cấp độ exception.
- Inventory policy các giá trị trong Merchant Center, Search Console, feeds/API, sản phẩm markup, và organization markup.
- Xác nhận mà nguồn wins dưới đó applicable precedence rules.
- Attach đó object qua
hasMerchantReturnPolicy; không publish điều này alone. - Supply either đó bắt buộc country/category path hoặc
merchantReturnLinkas appropriate. - Thêm
merchantReturnDayscho một finite window. - Giữ
applicableCountrytách biệt từreturnPolicyCountry. - Match fees, các phương thức, refund loại, window, và exceptions để visible policy text.
- Validate representative tiêu chuẩn-policy và exception các sản phẩm trước rollout.
Đó phạm vi → nguồn → consistency framework
- Phạm vi: dùng Organization cho đó default policy và Offer chỉ cho một genuine sản phẩm-cấp độ exception.
- Nguồn: identify đó controlling hệ thống—Nội dung API/feed, Merchant Center/Search Console setting, sản phẩm markup, hoặc organization markup.
- Consistency: làm đó winning machine-readable các giá trị, on-trang policy, checkout behavior, và customer-service terms agree.
Khi displayed trả về information là sai, inspect precedence trước editing JSON-LD. Correct markup tại một thấp hơn-priority layer có thể không bao giờ become đó giá trị Google dùng.
Prove một trả về-policy implementation
Graph-placement kiểm thử
Kiểm thử để chạy: validate representative organization và sản phẩm các trang và inspect đó entity graph. Dự kiến kết quả: mỗi policy là connected qua hasMerchantReturnPolicy để đó dự kiến Organization hoặc Offer. Failure interpretation: đó entity là standalone, duplicated, hoặc attached tại đó sai phạm vi. Monitoring window: immediate sau deployment. Rollback trigger: sản phẩm exceptions overwrite hoặc conflict với đó sitewide policy unintentionally.
Bắt buộc-thuộc tính kiểm thử
Kiểm thử để chạy: validate mỗi policy category và country variant. Dự kiến kết quả: bắt buộc properties là present, including merchantReturnDays cho finite windows. Failure interpretation: đó policy path là incomplete hoặc dùng đó sai thuộc tính. Monitoring window: mỗi policy/template thay đổi. Rollback trigger: không hợp lệ các giá trị là published trên đó catalog.
Cross-nguồn consistency kiểm thử
Kiểm thử để chạy: so sánh visible policy text, JSON-LD, feed/API các giá trị, và Merchant Center/Search Console settings cho đó giống nhau sản phẩm và country. Dự kiến kết quả: đó controlling nguồn và customer-facing terms agree. Failure interpretation: một cao hơn-precedence nguồn là stale hoặc regional phạm vi là mismatched. Monitoring window: mỗi policy launch và scheduled quarterly review. Rollback trigger: tìm kiếm-displayed terms promise conditions đó merchant không honor.
Worked JSON-LD các ví dụ
Những là illustrative structures cho thấy nơi MerchantReturnPolicy nests và mà properties go nơi. Validate bất kỳ real implementation trong đó Rich Kết quả Kiểm thử và kiểm tra điều này so với Google trả về-policy doc, since đó thuộc tính các bảng thay đổi.
1. Organization-cấp độ — một site-wide policy (Option MỘT, finite window)
{
"@context": "https://schema.org",
"@type": "OnlineStore",
"name": "Example Store",
"url": "https://example.com",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": ["US", "CA"],
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn",
"refundType": "https://schema.org/FullRefund"
}
}Note đó finite window pairs với merchantReturnDays: 30 — bắt buộc together. Đó
enum các giá trị là đầy đủ schema.org URLs, không đơn giản text.
2. Organization-cấp độ — Option B, chỉ một link
{
"@context": "https://schema.org",
"@type": "OnlineStore",
"name": "Example Store",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"merchantReturnLink": "https://example.com/returns"
}
}Đó escape hatch: nếu bạn không thể giữ detailed markup hiện tại, một link để của bạn policy trang là hợp lệ on của nó own.
3. Offer-cấp độ override — một sản phẩm với một khác nhau policy
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Final-Sale Widget",
"offers": {
"@type": "Offer",
"price": "19.99",
"priceCurrency": "USD",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnNotPermitted"
}
}
}Offer-cấp độ wins over an organization-cấp độ default — ở đây, một cuối-sale item đó overrides một site-wide 30-day policy với “không trả về.”
4. applicableCountry so với. returnPolicyCountry — Google own ví dụ shape
{
"@type": "MerchantReturnPolicy",
"applicableCountry": ["DE", "AT", "CH"],
"returnPolicyCountry": "IE",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 14
}Đó policy áp dụng để Germany, Austria, và Switzerland (applicableCountry), nhưng
đó physical trả về address là Ireland (returnPolicyCountry) — hai khác nhau
concepts, hai khác nhau properties.
5. Seasonal override cho holiday trả về
{
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 30,
"returnPolicySeasonalOverride": {
"@type": "MerchantReturnPolicySeasonal",
"startDate": "2026-11-01",
"endDate": "2026-12-31",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 60
}
}MỘT năm-round 30-day window với an extended 60-day holiday window layered on top cho một fixed date range.
Các tài nguyên worth của bạn time
My related writing
- Dữ liệu có cấu trúc: Điều gì Điều này Là và Cách Dùng Điều này — my Ahrefs hướng dẫn để schema types, JSON-LD, validation, và đó “not a ranking factor” (bản dịch) «không phải là yếu tố xếp hạng» reality đó áp dụng để trả về markup cũng.
- Đó Beginner Hướng dẫn để SEO kỹ thuật — nơi dữ liệu có cấu trúc fits vào đó rộng hơn kỹ thuật picture.
My speaking
- Cách Tìm kiếm Hoạt động (SlideShare) — my walkthrough of crawling, kết xuất, lập chỉ mục, và xếp hạng; hữu ích context cho nơi markup nhận đọc. (My standing disclaimer áp dụng: “This is my understanding of systems… not going to be 100% complete or accurate.” (bản dịch) «Này là my understanding of các hệ thống… không going để là 100% hoàn tất hoặc chính xác.»)
Chính thức
- Google Merchant Trả về Policy dữ liệu có cấu trúc doc — đó canonical reference cho properties, enums, và đó precedence hierarchy.
- Google Thêm markup hỗ trợ cho organization-cấp độ trả về policies (June 2024) và Hơn ways để share của bạn shipping và trả về policies (Nov 2025) — đó hai launch posts đó shaped đó hiện tại state.
- schema.org/MerchantReturnPolicy — đó vocabulary nguồn of truth.
Từ khoảng đó ngành
- Google Clarifies Organization Merchant Trả về Dữ liệu có cấu trúc (Search Engine Journal, Roger Montti, June 2024) — coverage of đó org-cấp độ launch và cách đó defaults/precedence hoạt động.
- Google shipping và trả về policies trong Search Console hoặc dùng new markup (Search Engine Land, Nov 2025) — coverage of đó November 2025 Search Console expansion.
- Google adds new trả về policy dữ liệu có cấu trúc hỗ trợ cho merchant listing (Search Engine Land, Barry Schwartz) — coverage of đó original 2023 Offer-cấp độ launch.
- Google Adds Organization Cấp độ Trả về Policy Dữ liệu có cấu trúc Hỗ trợ (Công cụ tìm kiếm Roundtable) — một concise ghi-lên of đó June 2024 thay đổi.
- Set lên của bạn trả về policies cho Shopping quảng cáo và danh sách miễn phí (Google Merchant Center Help) — đó non-markup path, straight từ đó nguồn.
Tự kiểm tra: MerchantReturnPolicy Schema
Five nhanh các câu hỏi on cách trả về-policy dữ liệu có cấu trúc hoạt động. Pick an câu trả lời cho mỗi, thì kiểm tra.
Nhật ký thay đổi
Đã cập nhật 8 thg 8, 2026.
Tóm tắt biên tập và chi tiết thay đổi đã ghi nhận.Chi tiết thay đổi
-
Ghi chú thay đổi chi tiết hiện chỉ có bằng tiếng Anh.
Không thể so sánh đầy đủ — không có bản lưu trước đó cho lần sửa đổi này.
Đã cập nhật 18 thg 7, 2026.
Tóm tắt biên tập và chi tiết thay đổi đã ghi nhận.Chi tiết thay đổi
-
Ghi chú thay đổi chi tiết hiện chỉ có bằng tiếng Anh.
-
Ghi chú thay đổi chi tiết hiện chỉ có bằng tiếng Anh.
-
Ghi chú thay đổi chi tiết hiện chỉ có bằng tiếng Anh.
Không thể so sánh đầy đủ — không có bản lưu trước đó cho lần sửa đổi này.