Hướng dẫn về OfferShippingDetails Schema

TL;DR — OfferShippingDetails là một nhỏ block of code bạn thêm để một sản phẩm markup đó tells Google three điều: điều gì điều này costs để ship, nơi điều này ships để, và cách dài điều này takes. Google có thể thì cho thấy đó shipping line right trong đó tìm kiếm kết quả. As of muộn 2025 có hai places để put shipping info — một tại đó store cấp độ (một single default cho của bạn toàn bộ catalog) và một tại đó sản phẩm cấp độ (này loại, cho các sản phẩm đó differ) — và OfferShippingDetails là đó sản phẩm-cấp độ một.

Điều gì OfferShippingDetails là

Khi ai đó looks tại một sản phẩm trang, they có thể đọc đó shipping cost và đó “arrives in 3–5 days” (bản dịch) «arrives trong 3–5 days» line chỉ by looking. MỘT công cụ tìm kiếm sees đơn giản text và có để guess. OfferShippingDetails là code bạn thêm — thường as JSON-LD — đó spells điều này out dùng đó shared schema.org vocabulary: “shipping costs $5,” (bản dịch) «shipping costs $5, USD» “it ships to the US,” (bản dịch) «điều này ships để đó US,» “it takes 3–5 business days.” (bản dịch) «điều này takes 3–5 business days.»

Điều này lives bên trong đó Offer on một sản phẩm trang — đó giống nhau Offer đó đã holds đó price và availability (see sản phẩm schema). Google đọc điều này và có thể cho thấy một shipping-cost hoặc phân phối-estimate line trong của bạn tìm kiếm listing, especially trong Shopping-style kết quả.

Đó three điều này mô tả

OfferShippingDetails bundles three ideas:

• Cách nhiều — đó shipping cost (shippingRate).
• Nơi để — đó đích điều này áp dụng để, như một country hoặc một postal-code range (shippingDestination).
• Cách dài — đó phân phối time (deliveryTime), mà là thực sự hai numbers đã thêm together: cách dài của bạn warehouse takes để gửi điều này out (xử lý time) plus cách dài đó carrier takes để deliver điều này (transit time).

Đó big thay đổi trong muộn 2025

Until recently, này sản phẩm-cấp độ markup đã là đó main way để declare shipping trong dữ liệu có cấu trúc. Trong November 2025 Google đã thêm một second, store-cấp độ option: bạn có thể hiện tại declare một shipping policy cho của bạn toàn bộ business khi (một loại called ShippingService), thay vì repeating điều này on mỗi sản phẩm. Google hiện tại khuyến nghị đang làm đó as của bạn default, và dùng OfferShippingDetails chỉ cho các sản phẩm whose shipping là khác nhau từ đó default.

So đó đơn giản version:

• Một shipping policy cho mọi thứ? Declare điều này khi tại đó store cấp độ với ShippingService.
• MỘT cụ thể sản phẩm ships differently? Override điều này on đó sản phẩm với OfferShippingDetails.

Hai honest cautions

• đây là không bắt buộc, và điều này sẽ không lift của bạn thứ hạng. Thêm shipping markup làm bạn eligible cho đó shipping line trong tìm kiếm — điều này không move bạn lên đó kết quả. Dữ liệu có cấu trúc không bao giờ làm đó.
• Thêm điều này không bảo đảm điều này cho thấy. Nếu bạn cũng có một Google Merchant Center feed hoặc một shipping setting trong Search Console, những có thể âm thầm win over của bạn markup — với không lỗi để warn bạn. Hơn on đó trap trong đó Advanced tab.

Muốn đó đầy đủ version — mỗi thuộc tính, đó November 2025 restructure, mà nguồn wins khi several disagree, đó silent-failure trap, và hoạt động JSON-LD? Chuyển để đó Advanced tab.

TL;DR — OfferShippingDetails là đó schema.org loại nested dưới Offer (qua shippingDetails) đó declares shippingRate (một MonetaryAmount), shippingDestination (một DefinedRegion), và deliveryTime (handlingTime + transitTime). As of November 2025 đây là đó offer-cấp độ override half of một hai-tier hệ thống: Google hiện tại khuyến nghị declaring một catalog-wide default khi tại đó organization cấp độ với ShippingService (Organization.hasShippingService), và reserving OfferShippingDetails cho các sản phẩm đó differ — đó giống nhau org-cấp độ/offer-cấp độ split điều này dùng cho MerchantReturnPolicy. Hai điều confuse mọi người. (1) “Author your default at the org level” (bản dịch) «Tác giả của bạn default tại đó org cấp độ» và “product-level markup outranks org-level markup in a conflict” (bản dịch) «sản phẩm-cấp độ markup outranks org-cấp độ markup trong một conflict» là cả hai đúng — khác nhau axes. (2) Đó silent-failure trap: markup validates trong đó Rich Kết quả Kiểm thử nhưng nhận fully overridden by một Merchant Center feed giá trị hoặc một Search Console setting, với không lỗi until một listing rejection. shippingDetails là được khuyến nghị, không bắt buộc; đây là eligibility, không phải là yếu tố xếp hạng.

Điều gì OfferShippingDetails thực ra là

schema.org own một-liner là terse: “OfferShippingDetails represents information about shipping destinations.” (bản dịch) «OfferShippingDetails represents information về shipping destinations.» Trong thực tế đây là đó object bạn nest bên trong an Offer qua đó shippingDetails thuộc tính — schema.org mô tả đó thuộc tính as indicating “information about the shipping policies and options associated with an Offer.” (bản dịch) «information về đó shipping policies và options associated với an Offer.» Điều này sits right alongside price, priceCurrency, và availability trong đó giống nhau Offer đó powers của bạn sản phẩm schema.

Bạn có thể declare multiple OfferShippingDetails instances on một sản phẩm — đó là dự kiến, không phải lỗi — vì một sản phẩm có thể ship tại khác nhau rates để khác nhau places, hoặc tại khác nhau rate/speed tiers để đó giống nhau place.

Đó November 2025 restructure: OfferShippingDetails so với. ShippingService

Này là đó part gần như không existing hướng dẫn có folded trong, so đây là worth đang làm cẩn thận. On November 12, 2025 Google announced hai expanded ways để share shipping và trả về policies (Google Search Central blog, covered đó giống nhau day by Search Engine Journal): bạn có thể hiện tại configure shipping trực tiếp trong Search Console settings (opened lên để bất kỳ site Google classifiers identify as một merchant, không chỉ những với một linked Merchant Center account), và bạn có thể declare an organization-cấp độ ShippingService trong dữ liệu có cấu trúc.

ShippingService là một new schema.org loại — declared qua Organization.hasShippingService — đó cho phép bạn state một tiêu chuẩn shipping policy khi, on một single trang describing của bạn business shipping, thay vì repeating điều này on mỗi sản phẩm. Google own ShippingService tài liệu frames đó mối quan hệ từ đó side: “If you need to override your standard shipping policy for a specific product, specify one or more instances of the OfferShippingDetails type,” (bản dịch) «Nếu bạn cần để override của bạn tiêu chuẩn shipping policy cho một cụ thể sản phẩm, specify một hoặc hơn instances of đó loại,» nested dưới Offer — và notes đó sản phẩm-cấp độ policies hỗ trợ “a more limited set of properties than those described here for shipping policies specified under Organization.” (bản dịch) «một hơn limited set of properties hơn những described ở đây cho shipping policies specified dưới .»

So đó authoring hướng dẫn là:

• Org cấp độ (ShippingService) — đó được khuyến nghị default. Declare của bạn tiêu chuẩn policy khi. Google merchant-listing tài liệu chẳng hạn điều này trực tiếp: “We recommend you provide a global shipping policy for your business under Organization markup instead… Only if some of your products have specific shipping policies for which you need to override your global shipping policy, or if you don’t provide a standard shipping policy for your business, use this property under Offer.” (bản dịch) «We khuyến nghị bạn cung cấp một global shipping policy cho của bạn business dưới markup thay vì… Chỉ nếu some of của bạn các sản phẩm có cụ thể shipping policies cho mà bạn cần để override của bạn global shipping policy, hoặc nếu bạn không cung cấp một tiêu chuẩn shipping policy cho của bạn business, dùng này thuộc tính dưới .»
• Offer cấp độ (OfferShippingDetails) — đó override. Dùng điều này cho đó các sản phẩm đó genuinely ship differently, hoặc as đó fallback nếu bạn không bao giờ declared an org-cấp độ default.

Google được xây dựng này để reduce theo-sản phẩm markup maintenance cho lớn catalogs đó all share một policy. Nếu bạn know đó MerchantReturnPolicy pattern — một default tại Organization.hasMerchantReturnPolicy, an override dưới đó Offer — này là đó giống nhau architecture applied để shipping. Google đã được actively tightening này toàn bộ thuộc tính cluster: điều này đã làm returnPolicyCountry an explicitly bắt buộc trường on đó trả về-policy sibling trong March 2025, thì đã thêm đó entire ShippingService layer trong November 2025.

Đó schema.org proposal behind đó thay đổi (GitHub vấn đề #3617, initiated by Google Shopping engineer Irina Tuduce) là rõ ràng đó điều này “introduces a new type, ShippingService, that groups shipping constraints,” (bản dịch) «introduces một new loại, ShippingService, đó groups shipping constraints,» và đó “redundant fields from ShippingRateSettings are therefore… deprecated.” (bản dịch) «redundant các trường từ ShippingRateSettings là do đó… deprecated.» Note điều gì đó làm và không có nghĩa là: OfferShippingDetails itself đã là không deprecated — điều này đã là repositioned. Chỉ certain redundant các trường bên trong đó related ShippingRateSettings loại đã là dropped.

Đó properties, một by một

Bên trong an OfferShippingDetails object:

• shippingRate — một MonetaryAmount (hoặc ShippingRateSettings). schema.org: “The shipping rate is the cost of shipping to the specified destination.” (bản dịch) «Đó shipping rate là đó cost of shipping để đó specified đích.» Này là nơi một value of 0 marks free shipping. ShippingRateSettings là điều gì đó 2025 restructure extended để hỗ trợ percentage-of-order-giá trị và percentage-of-weight rates.
• shippingDestination — một DefinedRegion. schema.org: điều này “indicates (possibly multiple) shipping destinations. These can be defined in several ways, e.g. postalCode ranges.” (bản dịch) «indicates (possibly multiple) shipping destinations. Những có thể là được định nghĩa trong several ways, e.g. postalCode ranges.» Bạn express điều này as một country (addressCountry), một region, hoặc một postal-code range — mà là vì sao một sản phẩm có thể carry several OfferShippingDetails entries cho khác nhau regions.
• shippingOrigin — cũng một DefinedRegion: “Indicates the origin of a shipment, i.e. where it should be coming from.” (bản dịch) «Indicates đó origin of một shipment, i.e. nơi điều này nên là coming từ.»
• deliveryTime — một ShippingDeliveryTime object. schema.org calls điều này “The total delay between the receipt of the order and the goods reaching the final customer.” (bản dịch) «Đó total delay giữa đó receipt of đó order và đó goods reaching đó cuối customer.» Crucially, đây là không một number — đây là đó sum of hai sub-properties (dưới).
• doesNotShip — một Boolean: “Indicates when shipping to a particular shippingDestination is not available.” (bản dịch) «Indicates khi shipping để một particular shippingDestination không phải khả dụng.»
• hasShippingService — một ShippingService (đó new org-cấp độ loại; này là đó link giữa đó hai tiers).
• validForMemberTier — ties một shipping option để một loyalty/membership tier (e.g. free shipping cho members).
• weight / height / width / depth — package dimensions dùng cho rate-matching.

deliveryTime = handlingTime + transitTime

Đó single hầu hết-missed detail. deliveryTime (một ShippingDeliveryTime) là đã làm of:

• handlingTime — schema.org: “The typical delay between the receipt of the order and the goods either leaving the warehouse or being prepared for pickup.” (bản dịch) «Đó typical delay giữa đó receipt of đó order và đó goods either leaving đó warehouse hoặc đang prepared cho pickup.» Này là của bạn processing delay trước bất cứ điều gì ships.
• transitTime — “The typical delay the order has been sent for delivery and the goods reach the final customer.” (bản dịch) «Đó typical delay đó order đã được đã gửi cho phân phối và đó goods reach đó cuối customer.» Này là đó carrier delay sau điều này ships.
• cutoffTime — “Order cutoff time allows merchants to describe the time after which they will no longer process orders received on that day. For orders processed after cutoff time, one day gets added to the delivery time estimate.” (bản dịch) «Order cutoff time cho phép merchants để mô tả đó time sau mà they sẽ không lâu hơn xử lý orders đã nhận on đó day. Cho orders processed sau cutoff time, một day nhận đã thêm để đó phân phối time estimate.»
• businessDays — đó days of đó week bạn thực ra xử lý orders.

Nếu một buyer sees “arrives in 4–7 business days,” (bản dịch) «arrives trong 4–7 business days,» đó là xử lý (chẳng hạn 1–2 days) plus transit (3–5 days), với cutoffTime bumping đó estimate một day cho muộn orders. Collapsing đó hai vào một single đã làm-lên transit number là một lỗi thường gặp.

Là điều này bắt buộc?

Không — và này là một persistent myth. shippingDetails là một được khuyến nghị, không bắt buộc, thuộc tính cho merchant-listing dữ liệu có cấu trúc. Đó chỉ bắt buộc merchant-listing properties là price (mà cho merchant listings phải được “greater than zero” (bản dịch) «greater hơn zero») và priceCurrency (ISO 4217). Bạn có thể earn một hợp lệ Sản phẩm rich kết quả với không shipping markup tại all.

có một tách biệt requirement mọi người conflate với này một: shipping information of some form — markup, một Merchant Center feed giá trị, hoặc một Search Console setting — là bắt buộc cho eligibility trong Google free sản phẩm listings trên khoảng 30 countries (theo Google Merchant Center Help; đó list spans Australia, Brazil, Canada, hầu hết of Western Europe, India, Japan, South Korea, đó UK, đó US, và hơn). đó là “you must supply shipping info somehow,” (bản dịch) «bạn phải supply shipping info somehow,» không “the shippingDetails schema property is mandatory.” (bản dịch) «đó schema thuộc tính là mandatory.» Hai khác nhau requirements.

Multiple options và Google tie-break logic

Vì bạn có thể (và thường nên) list several rate/speed combos — chẳng hạn $5 USD cho 5–7 days và $15 USD cho 1–2 days — Google cần một rule cho mà một để surface. Theo của nó ShippingService tài liệu và SEJ coverage: khi several entries có thể apply để đó giống nhau buyer và đích, Google cho thấy đó lowest-cost option và của nó associated speed, breaking cost ties by đó fastest speed. So listing một cheap-nhưng-chậm option có nghĩa là Google có thể cho thấy đó một — worth knowing trước khi bạn list điều này.

Precedence: điều gì wins khi sources conflict

Ở đây đó confusion đó trips lên nearly mọi người, và đây là worth stating as hai tách biệt các câu hỏi:

Câu hỏi MỘT — nơi nên I tác giả my default? Tại đó org cấp độ (ShippingService). đó là đó authoring khuyến nghị trên.

Câu hỏi B — khi several sources declare shipping cho đó giống nhau sản phẩm, mà giá trị làm Google thực ra dùng? MỘT khác nhau câu hỏi với một khác nhau câu trả lời. Google own Merchant Center tài liệu establishes hai links trong này chain trực tiếp: item-cấp độ shipping settings có thể override account-cấp độ settings, và cập nhật pushed qua đó Nội dung API cho Shopping hoặc Merchant API có thể overwrite manual Merchant Center edits. Đó đầy đủ four-tier stack dưới — mà folds trong dữ liệu có cấu trúc cũng — là magstags’ practitioner synthesis, consistent với những hai được ghi lại links nhưng không itself một single chính thức Google nguồn, strongest để weakest:

1. Nội dung API cho Shopping / Merchant API (account-cấp độ settings) — strongest.
2. Merchant Center hoặc Search Console shipping settings.
3. Sản phẩm-cấp độ OfferShippingDetails markup.
4. Org-cấp độ ShippingService markup — weakest.

Notice đó apparent inversion: ShippingService là đó được khuyến nghị điều để tác giả, nhưng trong một conflict, sản phẩm-cấp độ OfferShippingDetails outranks điều này. Cả hai là đúng. “Where should my default live” (bản dịch) «Nơi nên my default trực tiếp» và “what wins in a fight” (bản dịch) «điều gì wins trong một fight» là khác nhau axes, và conflating them là đó top practitioner lỗi ở đây. As magstags diễn đạt điều này: “Stronger sources override weaker ones completely. There is no blending.” (bản dịch) «Stronger sources override weaker ones completely. Có không blending.»

Đó silent-failure trap

Này là đó single hầu hết valuable pattern để internalize — nhưng đây là worth đang precise về điều gì Google documents trực tiếp versus điều gì là một well-corroborated practitioner observation. Google own tài liệu xác nhận đó underlying mechanism: item- và account-cấp độ settings có thể silently override của bạn markup (đó precedence stack trên), và Merchant Center có thể disapprove một listing cho inaccurate hoặc bị thiếu shipping information. Điều gì Google tài liệu không spell out đầu đến cuối là đó chính xác failure sequence magstags các báo cáo: của bạn OfferShippingDetails markup validates perfectly trong đó Rich Kết quả Kiểm thử, thì nhận completely overridden by một Merchant Center feed giá trị hoặc một Tìm kiếm Console shipping setting sitting cao hơn trong đó precedence stack — với không lỗi surfaced anywhere. Đó chỉ symptom là an eventual listing rejection nếu đó displayed shipping cost không match điều gì một buyer sees tại checkout. Treat đó sequence as một mạnh practitioner pattern để kiểm tra cho, không an chính thức Google bảo đảm. magstags cũng flags đó related gotcha đó shipping/trả về policies edited trong Merchant Center become chỉ đọc trong Search Console cho 30 days. Nếu của bạn markup “isn’t showing,” (bản dịch) «không cho thấy,» kiểm tra đó cao hơn tiers of đó stack trước khi bạn touch đó markup.

Google so với. Bing

Đó asymmetry là stark. Bing có không dedicated shipping-schema tài liệu paralleling Google merchant-listing / ShippingService tài liệu, không OfferShippingDetails hoặc ShippingService bắt buộc-thuộc tính các bảng, và không tương đương để Google free-listings shipping requirement. Bing Quản trị viên web Tools validates schema.org markup generically, nhưng không publish một bespoke shipping feature. Này là đó giống nhau pattern đó commerce schema hub đã documents cho ProductGroup — treat Bing as “generic schema.org support, no bespoke shipping feature” (bản dịch) «generic schema.org hỗ trợ, không bespoke shipping feature» until một Bing rep says nếu không, thay vì assuming parity với Google.

Làm điều này help thứ hạng?

Không — giống nhau caveat as all dữ liệu có cấu trúc. Điều này buys eligibility cho đó shipping line trong một merchant listing hoặc knowledge panel; điều này không phải một tín hiệu xếp hạng. John Mueller đã được blunt on đó chung point: “Structured data won’t make your site rank better,” (bản dịch) «Dữ liệu có cấu trúc sẽ không làm trang web của bạn xếp hạng tốt hơn,» và đó dùng điều này cho other purposes “won’t cause problems, but you’re unlikely to see any visible change from it in Google Search” (bản dịch) «sẽ không nguyên nhân các vấn đề, nhưng bạn là khó có khả năng để see bất kỳ visible thay đổi từ điều này trong Google Search» (relayed qua Công cụ tìm kiếm Roundtable).

”Is schema dying?” (bản dịch) «Là schema dying?» — một nhanh disambiguation

Bạn có thể có seen muộn-2025 coverage đó Google sẽ “remove support for [certain] structured data types in Search Console and its API” (bản dịch) «xóa hỗ trợ cho [certain] dữ liệu có cấu trúc types trong Search Console và của nó API» starting January 2026 (theo SEJ). Đó là một nhỏ set of unrelated, underused types — điều này có không có gì để làm với shipping schema. Đó opposite happened ở đây: shipping schema đã là expanded (ShippingService đã thêm) trong November 2025, đó giống nhau season đó “schema is dying” (bản dịch) «schema là dying» narrative đã là circulating. Mueller cách diễn đạt đó week — “markup types come and go, but a precious few you should hold on to” (bản dịch) «markup types come và go, nhưng một precious một vài bạn nên hold on để» (SER) — là đó right lens: không strip hợp lệ shipping markup on một sai alarm.

Nơi này sits

OfferShippingDetails là một thuộc tính-cấp độ loại trong đó dữ liệu có cấu trúc sub-cluster, nested dưới đó commerce schema hub alongside Product và ProductGroup. Của nó closest sibling là MerchantReturnPolicy — đó giống nhau org-cấp độ-default / offer-cấp độ-override architecture applied để trả về thay vì shipping. Cho đó rộng hơn vocabulary, deprecation cycles, và cách chọn một loại, see schema markup; cho đó format itself, JSON-LD.

AI summary

MỘT condensed take on đó Advanced version:

• Điều gì điều này là. OfferShippingDetails (schema.org) là dữ liệu có cấu trúc nested dưới an Offer qua shippingDetails. Điều này declares shippingRate (một MonetaryAmount), shippingDestination (một DefinedRegion), và deliveryTime. Bạn có thể list multiple instances theo sản phẩm (khác nhau regions hoặc rate/speed tiers).
• Đó Nov 2025 hai-tier hệ thống. Google hiện tại khuyến nghị declaring một catalog-wide default khi tại đó org cấp độ với ShippingService (Organization.hasShippingService), và dùng OfferShippingDetails chỉ as đó theo-sản phẩm override — đó giống nhau split điều này dùng cho MerchantReturnPolicy. OfferShippingDetails đã là repositioned, không deprecated; chỉ redundant các trường trong ShippingRateSettings đã là dropped.
• deliveryTime = handlingTime + transitTime. Xử lý là của bạn warehouse delay trước shipping; transit là đó carrier delay sau. cutoffTime adds một day cho muộn orders. đây là không một single number.
• Được khuyến nghị, không bắt buộc. Chỉ price (>0 cho merchant listings) và priceCurrency là bắt buộc cho một merchant listing. Riêng, shipping info of some form là bắt buộc cho free sản phẩm listings trong ~30 countries — một khác nhau requirement.
• Hai axes mọi người conflate. (MỘT) Nơi để tác giả của bạn default → org cấp độ. (B) Điều gì wins trong một conflict → precedence là Nội dung/Merchant API → Merchant Center/Search Console settings → sản phẩm-cấp độ OfferShippingDetails → org-cấp độ ShippingService. So đó offer-cấp độ override outranks đó org-cấp độ default trong một fight, mặc dù đó default là điều gì bạn là told để tác giả.
• Đó silent-failure trap. Markup có thể validate trong đó Rich Kết quả Kiểm thử tuy vậy là fully overridden by một feed giá trị hoặc Search Console setting với không lỗi — chỉ một sau đó listing rejection nếu đó shown cost mismatches checkout. Policies edited trong Merchant Center go chỉ đọc trong Search Console cho 30 days.
• Tie-break. Với multiple options, Google cho thấy đó lowest cost (fastest speed breaks ties).
• Không phải là yếu tố xếp hạng; Bing có không bespoke shipping feature. Eligibility chỉ (Mueller). Đó Jan 2026 Search Console loại sunset là unrelated — shipping schema đã là expanded, không cut.

Tài liệu chính thức

Chính-nguồn tài liệu từ Google và schema.org.

schema.org

• OfferShippingDetails — đó loại itself và của nó đầy đủ thuộc tính bảng.
• shippingDetails — đó Offer thuộc tính đó nests điều này.
• ShippingDeliveryTime — handlingTime, transitTime, cutoffTime, businessDays.
• ShippingService — đó org-cấp độ loại đã thêm trong đó November 2025 restructure.

Google

• Merchant listing (sản phẩm) dữ liệu có cấu trúc — bắt buộc so với. được khuyến nghị properties, và đó “provide a global shipping policy under Organization instead” (bản dịch) «cung cấp một global shipping policy dưới Organization thay vì» callout.
• Shipping policy (ShippingService) dữ liệu có cấu trúc — đó November 2025 org-cấp độ doc, đó override mối quan hệ, và ShippingConditions.
• Trả về policy (MerchantReturnPolicy) dữ liệu có cấu trúc — đó architecturally parallel sibling loại.
• Sản phẩm dữ liệu có cấu trúc (overview) — nơi Offer và shippingDetails fit trong một Sản phẩm.
• Danh sách miễn phí — country requirements (Merchant Center Help) — đó ~30-country shipping-info requirement.
• Supported dữ liệu có cấu trúc các thuộc tính và các giá trị (Merchant Center Help) — cách feed các thuộc tính map để schema.

Google — blog announcements

• Hơn ways để share của bạn shipping và trả về policies (Nov 12, 2025) — đó hiện tại-state announcement (Search Console settings + org-cấp độ ShippingService).
• New Schema.org hỗ trợ cho retailer shipping dữ liệu (Sept 2020) — đó original shippingDetails announcement.

schema.org project

• Vấn đề #3617 — org-cấp độ shipping proposal — Irina Tuduce proposal đó introduced ShippingService.

Quotes từ đó nguồn

On-đó-record statements từ schema.org và Google. Nơi một trang exposes đó text, đó link là một deep link đó jumps để đó quoted passage.

schema.org — đó loại và của nó properties

• “OfferShippingDetails represents information about shipping destinations.” (bản dịch) «OfferShippingDetails represents information về shipping destinations.» Nhảy đến trích dẫn
• On shippingDetails: “Indicates information about the shipping policies and options associated with an Offer.” (bản dịch) «Indicates information về đó shipping policies và options associated với an Offer.» Nhảy đến trích dẫn
• On deliveryTime: “The total delay between the receipt of the order and the goods reaching the final customer.” (bản dịch) «Đó total delay giữa đó receipt of đó order và đó goods reaching đó cuối customer.» Nhảy đến trích dẫn
• On handlingTime: “The typical delay between the receipt of the order and the goods either leaving the warehouse or being prepared for pickup.” (bản dịch) «Đó typical delay giữa đó receipt of đó order và đó goods either leaving đó warehouse hoặc đang prepared cho pickup.» Nhảy đến trích dẫn
• On transitTime: “The typical delay the order has been sent for delivery and the goods reach the final customer.” (bản dịch) «Đó typical delay đó order đã được đã gửi cho phân phối và đó goods reach đó cuối customer.» Nhảy đến trích dẫn

Google — đó org-cấp độ khuyến nghị (đó 2025 repositioning)

• “We recommend you provide a global shipping policy for your business under Organization markup instead… Only if some of your products have specific shipping policies for which you need to override your global shipping policy, or if you don’t provide a standard shipping policy for your business, use this property under Offer.” (bản dịch) «We khuyến nghị bạn cung cấp một global shipping policy cho của bạn business dưới markup thay vì… Chỉ nếu some of của bạn các sản phẩm có cụ thể shipping policies cho mà bạn cần để override của bạn global shipping policy, hoặc nếu bạn không cung cấp một tiêu chuẩn shipping policy cho của bạn business, dùng này thuộc tính dưới .» — Google Search Central, merchant-listing tài liệu. Nhảy đến trích dẫn Relayed qua đó fetch tool text extraction of đó trực tiếp trang này session; xác nhận đó chính xác #:~:text= fragment trong-trình duyệt trước treating as cuối.

Google — đó override mối quan hệ (từ đó ShippingService side)

• “If you need to override your standard shipping policy for a specific product, specify one or more instances of the OfferShippingDetails type.” (bản dịch) «Nếu bạn cần để override của bạn tiêu chuẩn shipping policy cho một cụ thể sản phẩm, specify một hoặc hơn instances of đó loại.» — Google Search Central, shipping-policy tài liệu. Nhảy đến trích dẫn
• “Many merchants have shipping policies that outline the process of shipping purchased products for customers. When you add ShippingService structured data to your site, Google Search can use this information to display shipping information alongside your products.” (bản dịch) «Nhiều merchants có shipping policies đó outline đó xử lý of shipping purchased các sản phẩm cho customers. Khi bạn thêm dữ liệu có cấu trúc để trang web của bạn, Google Search có thể dùng này information để display shipping information alongside của bạn các sản phẩm.» Nhảy đến trích dẫn

John Mueller, Google — đây là không phải là yếu tố xếp hạng

• “Structured data won’t make your site rank better.” (bản dịch) «Dữ liệu có cấu trúc sẽ không làm trang web của bạn xếp hạng tốt hơn.» Đọc bài đưa tin
• “Exactly. Understand that markup types come and go, but a precious few you should hold on to (like title, and meta robots).” (bản dịch) «Chính xác. Understand đó markup types come và go, nhưng một precious một vài bạn nên hold on để (như tiêu đề, và meta robots).» Đọc bài đưa tin

schema.org GitHub proposal (#3617) — đó restructure rationale

• “This change introduces a new type, ShippingService, that groups shipping constraints… Redundant fields from ShippingRateSettings are therefore… deprecated.” (bản dịch) «Này thay đổi introduces một new loại, ShippingService, đó groups shipping constraints… Redundant các trường từ ShippingRateSettings là do đó… deprecated.» Đọc đó proposal

Mà shipping loại nên I dùng?

Đó toàn bộ “OfferShippingDetails vs. ShippingService vs. do nothing” (bản dịch) «OfferShippingDetails so với. ShippingService so với. làm không có gì» câu hỏi trong một path. Remember: này là đó authoring câu hỏi (“where do I put it” (bản dịch) «nơi làm I put điều này»), mà là tách biệt từ precedence (“what wins in a conflict” (bản dịch) «điều gì wins trong một conflict») — see đó Bảng tra nhanh cho đó.

OfferShippingDetails — bảng tra nhanh

Hai tiers, hai jobs

Đó cốt lõi properties (bên trong OfferShippingDetails)

deliveryTime breakdown

Precedence — điều gì wins trong một conflict (strongest → weakest)

1. Nội dung API cho Shopping / Merchant API
2. Merchant Center / Search Console settings
3. Sản phẩm-cấp độ OfferShippingDetails
4. Org-cấp độ ShippingService

Hai khác nhau các câu hỏi: nơi để tác giả của bạn default (org cấp độ) so với. điều gì wins trong một fight (offer cấp độ outranks org cấp độ). Cả hai đúng. “Stronger sources override weaker ones completely. There is no blending.” (bản dịch) «Stronger sources override weaker ones completely. Có không blending.»

Fast facts

• shippingDetails là được khuyến nghị, không bắt buộc — chỉ price (>0) và priceCurrency là bắt buộc cho một merchant listing.
• Shipping info of some form là bắt buộc cho danh sách miễn phí trong ~30 countries — một tách biệt requirement.
• Multiple entries welcome; Google cho thấy đó lowest cost (fastest speed breaks ties).
• Không phải là yếu tố xếp hạng — eligibility chỉ.
• Silent-failure trap: validates trong đó Rich Kết quả Kiểm thử, vẫn overridden by một feed / Search Console setting với không lỗi. Policies edited trong Merchant Center là chỉ đọc trong Search Console cho 30 days.
• OfferShippingDetails đã là repositioned, không deprecated, trong Nov 2025.

Hoạt động JSON-LD

Illustrative các ví dụ — validate của bạn own trong đó Rich Kết quả Kiểm thử và đó schema.org validator trước shipping, và hãy bảo đảm đó các giá trị match của bạn feed và checkout chính xác.

1. Offer-cấp độ OfferShippingDetails (đó theo-sản phẩm override)

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Merino Wool Beanie",
  "offers": {
    "@type": "Offer",
    "price": 29.00,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": 5.00,
        "currency": "USD"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "US"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": {
          "@type": "QuantitativeValue",
          "minValue": 0,
          "maxValue": 1,
          "unitCode": "DAY"
        },
        "transitTime": {
          "@type": "QuantitativeValue",
          "minValue": 2,
          "maxValue": 5,
          "unitCode": "DAY"
        }
      }
    }
  }
}

Đó advertises $5 USD US shipping với một 0–1 day xử lý window plus 2–5 days trong transit — i.e. “arrives in about 2–6 business days.” (bản dịch) «arrives trong về 2–6 business days.»

2. Multiple shipping options (tiêu chuẩn so với. expedited)

shippingDetails takes an array — list mỗi tier và let Google apply của nó tie-break (lowest cost, fastest speed breaks ties):

"shippingDetails": [
  {
    "@type": "OfferShippingDetails",
    "shippingRate": { "@type": "MonetaryAmount", "value": 5.00, "currency": "USD" },
    "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "US" },
    "deliveryTime": {
      "@type": "ShippingDeliveryTime",
      "transitTime": { "@type": "QuantitativeValue", "minValue": 5, "maxValue": 7, "unitCode": "DAY" }
    }
  },
  {
    "@type": "OfferShippingDetails",
    "shippingRate": { "@type": "MonetaryAmount", "value": 15.00, "currency": "USD" },
    "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "US" },
    "deliveryTime": {
      "@type": "ShippingDeliveryTime",
      "transitTime": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 2, "unitCode": "DAY" }
    }
  }
]

3. Free shipping

Free shipping là chỉ một shippingRate với một value of 0:

"shippingRate": { "@type": "MonetaryAmount", "value": 0, "currency": "USD" }

4. không ship để một region

{
  "@type": "OfferShippingDetails",
  "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "AU" },
  "doesNotShip": true
}

Đó org-cấp độ ShippingService (declared dưới Organization.hasShippingService) là đó được khuyến nghị default để tác giả khi của bạn toàn bộ catalog chia sẻ một policy — reserve đó offer-cấp độ chặn trên cho đó các sản phẩm đó genuinely differ.

Mistakes và myths

Đó recurring ways OfferShippingDetails dẫn đến sai lầm:

• “shippingDetails is required for Product rich results.” (bản dịch) «là bắt buộc cho Sản phẩm rich kết quả.» Điều này không — đây là một được khuyến nghị thuộc tính cho đó shipping-details enhancement. Chỉ price (>0 cho merchant listings) và priceCurrency là bắt buộc. (Riêng, shipping info of some form là bắt buộc cho danh sách miễn phí trong ~30 countries — một khác nhau điều.)
• “Adding OfferShippingDetails guarantees my shipping cost shows.” (bản dịch) «Thêm OfferShippingDetails bảo đảm my shipping cost cho thấy.» Không. MỘT Merchant Center feed giá trị hoặc một Search Console setting sits cao hơn trong đó precedence stack và có thể silently override hợp lệ markup — với không lỗi until an eventual listing rejection. Kiểm tra đó cao hơn tiers trước khi bạn touch đó markup.
• “ShippingService replaces / deprecates OfferShippingDetails.” (bản dịch) «replaces / deprecates .» Không. OfferShippingDetails là đó ongoing override dưới Offer. Chỉ certain redundant các trường bên trong ShippingRateSettings đã là deprecated — không đó loại.
• Conflating đó hai axes. “Author your default at the org level” (bản dịch) «Tác giả của bạn default tại đó org cấp độ» (authoring) và “product-level markup outranks org-level in a conflict” (bản dịch) «sản phẩm-cấp độ markup outranks org-cấp độ trong một conflict» (precedence) là cả hai đúng và câu trả lời khác nhau các câu hỏi. không reason as nếu một contradicts đó other.
• Collapsing deliveryTime vào một number. đây là handlingTime (của bạn processing delay) plus transitTime (đó carrier delay). Xuất bản một single đã làm-lên “shipping time” (bản dịch) «shipping time» misstates cả hai — và nếu điều này disagrees với checkout, risks rejection.
• Markup đó disagrees với đó feed hoặc checkout. Vì stronger sources override completely, một shipping cost trong của bạn markup đó không match của bạn feed hoặc thực tế checkout là một rejection risk, không một harmless duplicate. Giữ them giống hệt.
• “Schema is dying, so skip shipping markup.” (bản dịch) «Schema là dying, so skip shipping markup.» Này conflates đó January 2026 Search Console sunset of vài unrelated, underused types với shipping schema — mà đã là expanded trong November 2025, không cut.
• “Structured data like this will help rankings.” (bản dịch) «Dữ liệu có cấu trúc như này sẽ help thứ hạng.» Không — điều này earns rich-kết quả eligibility, không bao giờ một xếp hạng boost (Mueller, repeatedly).

Phổ biến shipping-markup các vấn đề

Validator accepts đó JSON-LD nhưng shipping dữ liệu là sai

Nguyên nhân: hợp lệ syntax có thể vẫn contain stale regions, rates, hoặc timing. Cách sửa: reconcile markup với checkout và feed/business-policy dữ liệu.

Shipping details xuất hiện cho đó sai đích

Nguyên nhân: đích constraints là bị thiếu hoặc modeled tại đó sai cấp độ. Cách sửa: map mỗi service và đích explicitly và kiểm thử representative addresses.

Multiple shipping sources disagree

Nguyên nhân: trang markup, Merchant Center, và account settings là maintained riêng. Cách sửa: chọn an operational nguồn of truth và synchronize mỗi surface.

Validation các kiểm thử

Kiểm thử published shipping markup

Kiểm thử để chạy — validate representative sản phẩm các trang và so sánh parsed destinations, rates, xử lý, và transit các giá trị với checkout. Dự kiến kết quả — eligible markup matches điều gì một người dùng nhận. Failure interpretation — mapping hoặc nguồn dữ liệu là incomplete. Monitoring window — immediate. Rollback trigger — xóa đó rollout nếu điều này publishes materially sai shipping promises.

Kiểm thử nguồn consistency

Kiểm thử để chạy — so sánh trang JSON-LD, feed/account shipping settings, và checkout cho đó giống nhau các sản phẩm và destinations. Dự kiến kết quả — không unexplained conflict. Failure interpretation — tách biệt các hệ thống có drifted. Monitoring window — sau mỗi policy thay đổi. Rollback trigger — restore đó cuối cùng consistent configuration nếu một thay đổi tạo mismatches.

Tự kiểm tra: OfferShippingDetails Schema

Five nhanh các câu hỏi on cách OfferShippingDetails hoạt động và nơi điều này fits sau đó November 2025 restructure. Pick an câu trả lời cho mỗi, thì kiểm tra.

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, implementation, validation, và đó sameAs risk; đó rộng hơn context này shipping loại sits bên trong.
• Đó Beginner Hướng dẫn để SEO kỹ thuật — nơi dữ liệu có cấu trúc fits trong đó wider 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à cách markup là consumed. (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 listing dữ liệu có cấu trúc và Shipping policy (ShippingService) — đó hai reference tài liệu đó define bắt buộc/được khuyến nghị properties và đó org-cấp độ/offer-cấp độ mối quan hệ.
• Google — Hơn ways để share của bạn shipping và trả về policies (Nov 12, 2025) — đó announcement of Search Console settings + org-cấp độ ShippingService.
• schema.org — OfferShippingDetails · ShippingDeliveryTime · ShippingService — đó vocabulary itself.
• schema.org proposal #3617 — đó GitHub vấn đề (Irina Tuduce, Google) behind đó restructure.

Từ khoảng đó ngành

• Google Launches Dữ liệu có cấu trúc Cho Merchant Shipping Policies (Search Engine Journal, Matt G. Southern, Nov 12 2025) — đó clearest bylined ghi-lên of đó November 2025 launch và đó tie-break logic.
• Google Không phải Diminishing Đó Dùng Of Dữ liệu có cấu trúc Trong 2026 (Search Engine Journal, Roger Montti, Nov 11 2025) — disambiguates đó January 2026 Search Console loại sunset từ đó shipping-schema expansion.
• Google Cập nhật Dữ liệu có cấu trúc Requirements Cho Trả về Policies (Search Engine Journal, Mar 14 2025) — đó March 2025 returnPolicyCountry tightening on đó sibling trả về-policy loại.
• Google shipping và trả về policies trong Search Console hoặc dùng new markup (Search Engine Land) — đó Search Console-so với-markup options laid out.
• Google Shipping & Trả về Settings (magstags) — đó strongest practitioner piece on đó precedence stack (“there is no blending” (bản dịch) «có không blending») và đó silent-failure trap.
• Google expands shipping policy options cho online merchants (ppc.land) — corroborating coverage of đó November 2025 thay đổi.

Nhật ký thay đổi