Panduan MerchantReturnPolicy Schema

MerchantReturnPolicy adalah schema.org jenis itu marks naik Anda kembalikan kebijakan untuk Google — nested di bawah Organization atau Offer, tidak pernah pada -nya own. Here adalah diperlukan properties, applicableCountry vs. returnPolicyCountry confusion, dan four-cara precedence hierarchy itu decides yang kebijakan sebenarnya menampilkan.

Pertama kali diterbitkan: 2 Jul 2026 · Terakhir diperbarui: 22 Agu 2026 · Advanced
Bahasa

MerchantReturnPolicy adalah schema.org jenis itu describes Anda kembalikan kebijakan — window, fees, metode, pengembalian dana jenis — di machine-readable form. single sebagian besar penting hal untuk melakukannya dengan benar: ini adalah sebuah nested, property-tingkat jenis, tidak pernah sebuah standalone markup. Anda attach ini via hasMerchantReturnPolicy di bawah Organization (satu situs-wide kebijakan) atau Offer (sebuah per-product override). setelah Anda gunakan ini, Google memerlukan satu dari dua options — applicableCountry + returnPolicyCategory, atau hanya merchantReturnLink — dan jika category adalah MerchantReturnFiniteReturnWindow, merchantReturnDays adalah diperlukan too. ini adalah Tidak diperlukan untuk tolok ukur Produk rich hasil; ini adalah sebuah recommended enhancement itu gates hanya mengembalikan menampilkan. Menonton dua traps: applicableCountry (tempat kebijakan applies) adalah tidak returnPolicyCountry (tempat item ships kembali untuk), dan sebuah kembalikan kebijakan dapat menjadi menetapkan di empat places — konten API, Merchant Center/Pencarian Console pengaturan, product-tingkat markup, organization-tingkat markup — itu ikuti sebuah ketat precedence order, dengan Pencarian Console pengaturan overriding Anda pada-halaman markup sepenuhnya.

TL;DR — MerchantReturnPolicy adalah sebuah nested, property-tingkat jenis, tidak sebuah standalone markup: ini adalah nilai dari hasMerchantReturnPolicy pada Organization (situs-wide bawaan) atau Offer (per-product override). diperlukan adalah sebuah two-option pilihan — applicableCountry + returnPolicyCategory, atau merchantReturnLink; dan MerchantReturnFiniteReturnWindow membuat merchantReturnDays diperlukan. applicableCountry (tempat kebijakan applies) adalah tidak returnPolicyCountry (tempat item physically ships kembali untuk) — itu conflation adalah spreading dan ini adalah salah. ini adalah tidak sebuah base-eligibility requirement untuk Produk rich hasil — ini adalah sebuah direkomendasikan penyempurnaan gating hanya mengembalikan menampilkan. dan sebuah kembalikan kebijakan dapat menjadi ditetapkan di empat places dengan sebuah ketat precedence order (konten API → Merchant Center/Pencarian Console pengaturan → product-tingkat markup → organization-tingkat markup), tempat Pencarian Console pengaturan override Anda pada-halaman data terstruktur sepenuhnya.

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

Apa ini sebenarnya adalah — sebuah nested jenis, tidak sebuah listing jenis

ini adalah mental model semuanya lainnya hangs pada. MerchantReturnPolicy adalah tidak sebuah schema Anda mark naik pada -nya own sebagai primary jenis dari sebuah halaman, cara Anda akan Product atau JobPosting. ini adalah sebuah property-tingkat jenis: sebuah instance dari ini adalah nilai dari hasMerchantReturnPolicy properti, attached untuk satu dari dua parent jenis.

Google’s own dokumentasi lay keluar dua tingkat explicitly: “sebuah standar kembalikan kebijakan untuk Anda bisnis itu applies untuk sebagian besar atau semua produk Anda sell dapat menjadi specified menggunakan MerchantReturnPolicy data terstruktur jenis nested di bawah Organization data terstruktur jenis menggunakan hasMerchantReturnPolicy properti. jika Anda perlu override Anda standar kembalikan kebijakan untuk sebuah spesifik produk, specify satu atau lebih instances dari MerchantReturnPolicy di bawah Offer jenis.”

Jadi ini adalah sebuah companion untuk Product/Offer jenis, tidak sebuah pesaing untuk them. jika Anda telah membaca my commerce schema hub — my practitioner label untuk schema.org listing jenis (Product, ProductGroup, JobPosting) itu mendapatkan mereka own rich hasil — MerchantReturnPolicy adalah deliberately tidak di itu group. itu adalah halaman Anda mark naik; ini adalah sebuah properti Anda attach untuk them.

diperlukan properties: sebuah two-option pilihan

setelah Anda gunakan ini, Google memerlukan satu dari dua options — “memilih opsi itu terbaik suits Anda menggunakan kasus” (terjemahan) “memilih opsi itu terbaik suits Anda gunakan kasus”:

Opsi sebuah — structured detail:

  • applicableCountry (Teks) — ” negara code itu kebijakan pengembalian applies untuk (tempat produk adalah sold dan will menjadi returned dari). Menggunakan two-letter ISO 3166-1 alpha-2 negara code formatting. Anda dapat specify naik untuk 50 countries.” (terjemahan) “ negara code itu kembalikan kebijakan applies untuk (tempat produk adalah sold dan akan menjadi dikembalikan dari). gunakan two-letter ISO 3166-1 alpha-2 negara code formatting. Anda dapat specify naik untuk 50 countries.”
  • returnPolicyCategory (MerchantReturnEnumeration) — jenis dari kembalikan kebijakan, satu dari tiga enum nilai (di bawah).

Opsi B — hanya sebuah tautan:

  • merchantReturnLink (URL) — “Specify URL dari sebuah halaman web itu describes kebijakan pengembalian untuk Anda pelanggan. Ini dapat menjadi Anda own kebijakan pengembalian, atau sebuah third-party kebijakan dari sebuah service itu handles Anda returns.” (terjemahan) “Specify URL dari sebuah halaman web itu describes kembalikan kebijakan untuk Anda pelanggan. ini dapat menjadi Anda own kembalikan kebijakan, atau sebuah ketiga-party kebijakan dari sebuah service itu handles Anda mengembalikan.”

Opsi B adalah escape hatch untuk merchants siapa dapat’t pertahankan detailed markup saat ini — poin di kebijakan halaman dan menjadi done.

tiga returnPolicyCategory nilai

Straight dari Google’s dokumentasi, ini adalah satu-satunya tiga valid nilai, dan mereka harus menjadi penuh schema.org URL, tidak plain teks seperti “30 days” (terjemahan) “30 days” (menggunakan plain teks adalah satu dari paling umum validation errors):

  • https://schema.org/MerchantReturnFiniteReturnWindow“ada sebuah menetapkan angka dari days untuk pengembalian sebuah produk.” (terjemahan) “ada sebuah menetapkan angka dari days untuk mengembalikan produk.”
  • https://schema.org/MerchantReturnUnlimitedWindow“ada sebuah unlimited amount dari waktu untuk pengembalian sebuah produk.” (terjemahan) “ada sebuah unlimited amount dari waktu untuk mengembalikan produk.”
  • https://schema.org/MerchantReturnNotPermitted“Returns aren’t permitted.” (terjemahan) “mengembalikan bukan permitted.”

Ketika merchantReturnDays becomes diperlukan

ada satu conditional requirement untuk remember: “Jika Anda menggunakan MerchantReturnFiniteReturnWindow, lalu merchantReturnDays properti adalah diperlukan.” (terjemahan) “jika Anda gunakan MerchantReturnFiniteReturnWindow, lalu merchantReturnDays properti adalah diperlukan.” Jadi sebuah finite window tanpa sebuah day count adalah invalid — jika Anda mengatakan pelanggan memiliki sebuah menetapkan angka dari days, Anda memiliki untuk mengatakan cara banyak.

applicableCountry vs. returnPolicyCountry — properti everyone confuses

ini adalah worth -nya own bagian, karena sebuah factual kesalahan adalah actively spreading melalui secondary SEO konten — termasuk beberapa higher-authority coverage itu framed returnPolicyCountry sebagai “now required.” (terjemahan) “sekarang diperlukan.” ini bukan. Here’s perbedaan, straight dari aktif doc:

  • applicableCountry adalah diperlukan (sebagai bagian dari Opsi sebuah) dan describes tempat kebijakan applies — tempat produk adalah sold dan returnable dari.
  • returnPolicyCountry adalah direkomendasikan, tidak diperlukan, dan describes sesuatu berbeda: ” negara tempat produk memiliki untuk menjadi sent untuk returns. Ini negara dapat menjadi berbeda dari negara tempat produk adalah originally shipped atau sent untuk.” (terjemahan) “ negara tempat produk memiliki untuk menjadi dikirim untuk mengembalikan. ini negara dapat menjadi berbeda dari negara tempat produk adalah originally shipped atau dikirim untuk.”

Google’s own contoh membuat perbedaan concrete: "applicableCountry": ["DE", "AT", "CH"], "returnPolicyCountry": "IE" — i.e., kebijakan applies untuk (dan produk adalah returnable dari) Germany, Austria, dan Switzerland, tetapi physical kembalikan address adalah di Ireland. Dua berbeda concepts, dua berbeda properties. jika sebuah sumber memberi tahu Anda returnPolicyCountry adalah diperlukan, periksa ini terhadap Google’s kembalikan-policy doc — diperlukan field adalah applicableCountry.

direkomendasikan enrichment properties

Beyond diperlukan minimum, ini direkomendasikan properties membuat mengembalikan menampilkan richer. semua adalah enum-based:

  • returnFees (ReturnFeesEnumeration): FreeReturn, ReturnFeesCustomerResponsibility, atau ReturnShippingFees (sebuah merchant-charged pengiriman fee — specify non-zero amount dengan returnShippingFeesAmount).
  • returnMethod (ReturnMethodEnumeration): ReturnAtKiosk, ReturnByMail, ReturnInStore.
  • refundType (RefundTypeEnumeration): ExchangeRefund, FullRefund, StoreCreditRefund.
  • restockingFee (MonetaryAmount atau angka) — sebuah percentage atau fixed amount.
  • returnLabelSource (ReturnLabelSourceEnumeration): ReturnLabelCustomerResponsibility, ReturnLabelDownloadAndPrint, ReturnLabelInBox.
  • itemCondition, returnPolicyCountry, dan itemDefectReturnShippingFeesAmount round keluar umum menetapkan.

Worth knowing: schema.org’s vocabulary untuk MerchantReturnPolicy adalah larger daripada ini list — ini juga defines properties seperti customerRemorseReturnFees, inStoreReturnsOffered, dan validForMemberTier itu tidak muncul di Google’s own kembalikan-policy doc. Schema.org validity dan Google mendukung adalah dua berbeda hal. Stick untuk properties Google’s dokumentasi sebenarnya list jika Anda goal adalah mengembalikan rich-hasil fitur — broader vocabulary ada, tetapi Google hasn’t terdokumentasi itu ini membaca ini.

Seasonal overrides untuk holiday windows

kembalikan kebijakan sering loosen di atas holidays, dan ada sebuah properti untuk tepat itu: returnPolicySeasonalOverride (MerchantReturnPolicySeasonal). ini lets Anda specify sebuah berbeda kebijakan untuk sebuah date range — -nya own returnPolicyCategory, merchantReturnDays, dan startDate/endDate — tanpa touching Anda standar kebijakan. sebuah retailer running sebuah extended-holiday-mengembalikan window dapat layer itu pada atas dari year-round bawaan.

Organization-tingkat vs. Offer-tingkat: yang untuk gunakan

  • Organization-tingkat (hasMerchantReturnPolicy di bawah Organization) adalah untuk Anda standar, business-wide kebijakan. Menetapkan ini sekali dan ini applies broadly. ini adalah tepat bawaan untuk sebagian besar situs, dan ini ada secara khusus jadi Anda tidak memiliki untuk repeat kebijakan pada setiap produk halaman. Google recommends menggunakan satu dari OnlineStore atau LocalBusiness subtypes dari Organization untuk ini.
  • Offer-tingkat (hasMerchantReturnPolicy di bawah Offer) adalah hanya untuk genuine exceptions — sebuah spesifik produk whose kembalikan istilah differ dari Anda standar.

dan sebuah caution dari precedence aturan di bawah: product-tingkat (Offer) markup selalu wins di atas organization-tingkat, jadi sebuah stale atau incorrect Offer-tingkat override akan silently beat sebuah correct organization-tingkat bawaan. tidak sprinkle Offer-tingkat kebijakan “to be safe.” (terjemahan) “untuk menjadi safe.”

adalah MerchantReturnPolicy diperlukan untuk Produk rich hasil?

tidak — dan ini adalah myth sebagian besar worth busting. Google’s Produk intro doc lists ini sebagai sebuah direkomendasikan penyempurnaan, tidak sebuah base-eligibility requirement: “Di addition untuk data terstruktur untuk individual produk itu Anda sell, we juga merekomendasikan Anda menambahkan data terstruktur defining kebijakan dari Anda ecommerce bisnis, nested di bawah Organization markup: Merchant kebijakan pengembalian: Specify kebijakan pengembalian (atau kebijakan) untuk Anda bisnis.” (terjemahan) “di addition untuk data terstruktur untuk individual produk itu Anda sell, kami juga merekomendasikan Anda tambahkan data terstruktur defining kebijakan dari Anda ecommerce bisnis, nested di bawah Organization markup: Merchant kembalikan kebijakan: Specify kembalikan kebijakan (atau kebijakan) untuk Anda bisnis.” pada merchant-listing doc, hasMerchantReturnPolicy adalah sebuah direkomendasikan properti dari Offer, tidak satu dari diperlukan properties (seperti price dan priceCurrency) itu gate tolok ukur kelayakan.

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

Terjemahan: menghilangkan kembalikan-policy markup tidak mendiskualifikasi sebuah halaman dari produk cuplikan atau merchant listings. ini hanya berarti mengembalikan penyempurnaan tidak dapat tampilkan. ini adalah sebuah tambahkan-pada, tidak sebuah entry ticket. dan per broader data terstruktur hub, tidak ada dari ini adalah sebuah peringkat faktor — ini earns kelayakan untuk sebuah appearance, tidak position.

ini adalah juga worth menjadi precise tentang apa “correct markup” (terjemahan) “correct markup” sebenarnya proves. Valid schema.org syntax, Google-documented mendukung untuk sebuah properti, syntactically valid JSON-LD, rich-hasil kelayakan, dan kebijakan sebenarnya displaying di Pencarian adalah lima terpisah menyatakan — passing satu tidak jaminan next. dan tidak ada dari them adalah sebuah sinyal peringkat, sebuah hukum compliance jaminan, atau sebuah janji itu sebuah AI shopping permukaan akan membaca atau honor kebijakan cara Pencarian melakukan — Google’s docs don’t claim apa pun dari itu.

precedence hierarchy — nyata differentiator

Here’s bagian hampir tidak competing panduan menjelaskan dengan jelas. sebuah kembalikan kebijakan dapat menjadi ditetapkan di empat berbeda places, dan ketika lebih daripada satu ada, hanya satu wins. Google menyatakan order dari precedence, “from strongest to weakest” (terjemahan) “dari strongest untuk weakest”:

  1. konten API untuk Shopping (kembalikan pengaturan)
  2. Pengaturan di Merchant Center atau Pencarian Console
  3. Product-tingkat merchant listing markup (Offer)
  4. Organization-tingkat markup

I re-verified ini exact order terhadap Google’s aktif doc di Juli 2026, dan ini hasn’t diubah sejak November 2025 update di bawah — tetapi ini adalah sebuah doc family itu moves, jadi re-periksa ini terhadap aktif halaman alih-alih trusting apa pun snapshot, termasuk ini satu, indefinitely.

Google mengatakan ini plainly: “jika Anda provide keduanya kebijakan pengembalian markup pada Anda situs dan kebijakan pengembalian pengaturan di Pencarian Console, Google will hanya menggunakan informasi provided di Pencarian Console.” (terjemahan) “jika Anda menyediakan keduanya kembalikan kebijakan markup pada Anda situs dan kembalikan kebijakan pengaturan di Pencarian Console, Google akan hanya gunakan informasi disediakan di Pencarian Console.” Jadi Anda pada-halaman data terstruktur sits di bottom dari stack — sebuah Merchant Center atau Pencarian Console setting silently overrides ini. ini adalah single sebagian besar umum sumber dari “my markup is perfect but the wrong policy shows” (terjemahan) “my markup adalah perfect tetapi salah kebijakan menampilkan” confusion, dan ini adalah mengapa pertama hal untuk periksa ketika sebuah displayed kebijakan disagrees dengan Anda code adalah apakah sesuatu’s menetapkan di Pencarian Console atau Merchant Center.

“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.” (terjemahan) “if Anda provide keduanya return policy markup on Anda site dan return policy pengaturan in pencarian Console, Google will hanya menggunakan information provided in pencarian Console.”

melakukan Anda bahkan perlu markup? Merchant Center dan Pencarian Console alternatives

Google adalah upfront itu markup bukan satu-satunya path, dan sering tidak terbaik satu: “Retailer kembalikan kebijakan dapat mendapatkan complicated dan dapat perubahan frequently. jika Anda adalah having trouble indicating dan mempertahankan Anda kembalikan detail up-untuk-date dengan markup dan memiliki sebuah Google Merchant Center akun, pertimbangkan configuring Anda kembalikan kebijakan di Google Merchant Center. Anda dapat alternatively configure account-tingkat kembalikan kebijakan di Pencarian Console, yang mendapatkan secara otomatis ditambahkan untuk Merchant Center.”

Jadi decision adalah genuinely three-cara: markup (Organization atau Offer), Merchant Center pengaturan, atau Pencarian Console pengaturan. jika Anda sudah memiliki sebuah Merchant Center akun, Google recommends configuring mengembalikan ada alih-alih di markup — ini adalah easier untuk pertahankan saat ini, dan ini outranks markup bagaimanapun.

Recent perubahan: 2024–2025 timeline

ini doc family moves fast, jadi history penting:

  • 2023 — Google enabled kembalikan-policy data terstruktur untuk individual produk (Offer-tingkat) — starting poin, per Google’s own later framing.
  • June 11, 2024 — Google ditambahkan organization-tingkat hasMerchantReturnPolicy mendukung, jadi Anda dapat menetapkan satu business-wide kebijakan alih-alih mengulang ini per produk. Google Shopping engineers siapa announced ini (Irina Tuduce, Pascal Fleury, dan Johan Linder) framed ini sekitar merchants tanpa sebuah Merchant Center akun: “Adding sebuah kebijakan pengembalian untuk Anda organization data terstruktur adalah especially penting jika Anda tidak memiliki sebuah Merchant Center akun dan ingin ability untuk provide sebuah kebijakan pengembalian untuk Anda bisnis.” (terjemahan) “menambahkan sebuah kembalikan kebijakan untuk Anda organization data terstruktur adalah terutama penting jika Anda tidak memiliki sebuah Merchant Center akun dan ingin ability untuk menyediakan sebuah kembalikan kebijakan untuk Anda bisnis.”
  • November 12, 2025 — Google expanded Pencarian Console “Shipping and returns” (terjemahan) “Pengiriman dan mengembalikan” fitur untuk semua situs web identified sebagai online merchants (previously ini diperlukan sebuah Merchant Center akun), dan ditambahkan organization-tingkat pengiriman kebijakan markup. mereka catatan pada precedence adalah worth pinning untuk fridge: “ini adalah penting untuk catatan itu pengaturan configured di Pencarian Console will take precedence lebih dari structured data pada Anda situs.” (terjemahan) “ini adalah penting untuk catatan itu pengaturan configured di Pencarian Console akan take precedence di atas structured data pada Anda situs.”

Satu clarification pada itu November 2025 update: baru pengiriman kebijakan markup adalah sebuah terpisah jenis dari MerchantReturnPolicy — tidak conflate mengembalikan dan pengiriman. Pengiriman kebijakan adalah -nya own structured-data path (sebuah ShippingService-style jenis). ini artikel adalah tentang mengembalikan; pengiriman adalah sebuah sibling topik.

Cara Bing handles ini — spoiler, ini tidak (secara khusus)

menjadi honest tentang asymmetry. Bing’s Webmaster alat validate schema.org markup generically dan Bing membaca data terstruktur, tetapi Bing publishes tidak MerchantReturnPolicy-spesifik diperlukan/direkomendasikan properti table, tidak dedicated mengembalikan rich-hasil fitur, dan tidak equivalent untuk Google’s shopping knowledge-panel mengembalikan menampilkan. Bing’s ecommerce panduan lives di -nya Shopping-ads umpan specs, tidak di schema.org mengembalikan markup. ini mirrors yang sama pattern I noted untuk Product, ProductGroup, dan JobPosting di commerce hub: Bing validates generically; Google membangun dedicated fitur pada atas. Jadi implement mengembalikan markup untuk Google — dan tidak expect sebuah parallel Bing fitur.

umum mistakes dan Pencarian Console warnings

recurring ones:

  • Plain-text enum nilai. returnPolicyCategory harus menjadi penuh https://schema.org/... URL, tidak “30 days” (terjemahan) “30 days” atau “finite.” (terjemahan) “finite.” sama untuk returnFees, returnMethod, dan refundType.
  • Finite window dengan tidak day count. MerchantReturnFiniteReturnWindow tanpa merchantReturnDays adalah invalid.
  • Confusing applicableCountry dengan returnPolicyCountry (melihat di atas).
  • “Missing field hasMerchantReturnPolicy (in offers).” (terjemahan) “hilang field hasMerchantReturnPolicy (di offers).” ini Pencarian Console warning berarti mengembalikan penyempurnaan adalah unavailable karena properti adalah absent — tetapi map ini untuk precedence hierarchy sebelum Anda panic-tambahkan markup: jika Anda telah menetapkan mengembalikan di Pencarian Console atau Merchant Center, itu’s apa menampilkan bagaimanapun, dan markup warning dapat menjadi moot.
  • Markup/terlihat-konten mismatch. sebagai dengan semua data terstruktur, kebijakan di Anda markup seharusnya match apa’s sebenarnya pada halaman.
  • mengulang kembalikan markup pada setiap produk halaman ketika sebuah Organization-tingkat kebijakan akan cover them semua — entire poin dari 2024 peluncuran.

Tempat ini fits

MerchantReturnPolicy adalah sebuah companion deep-dive untuk commerce schema hub (Produk, ProductGroup, JobPosting) — ini adalah property-tingkat jenis Anda attach untuk Offer dan Organization, tidak sebuah fourth listing jenis. ini sits di dalam broader data terstruktur untuk SEO subcluster alongside schema markup, JSON-LD, dan rich hasil, yang di turn lives di pada-halaman SEO cluster. Shipping-policy markup — sibling itu shipped alongside November 2025 update — adalah sebuah terpisah jenis worth -nya own treatment.

Add an expert note

Pin an expert quote

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