Shopify 在 2026 年 11 月 13 日公布 Market metafield 的決勝規則變更:當一位買家同時符合兩個以上「同等具體」的 Markets,而且這些 Markets 對同一 metafield 設了不同值,系統不再選最近更新的值,而是選 handle 排序最低的 Market。變更涵蓋 Storefront API、Liquid 與 Function APIs 的所有 API 版本,Shopify 會先套用到結果不變的商店,可能受影響的商家則會收到聯絡,以便在套用前調整。

這不是所有 Shopify Markets 或所有 metafields 都會改值。官方列出多個條件必須同時成立:買家符合多個同等具體市場、沒有更具體的市場設定該欄位、重疊市場的值不同,而且原本最近更新的值不是最低 handle 的值。若商店只有彼此排他的國家市場,或同一欄位在重疊市場中內容相同,就不會因這項規則看到差異。

為什麼從更新時間改成 handle

舊規則以最近更新時間決勝,但 metafield 的更新時間在 Shopify admin 並不可見。營運人員只要編輯其中一個市場的內容,就可能在沒有察覺的情況下改變某群買家看到的文案、政策或設定。新的 handle 規則雖然仍需要治理,但至少 handle 可見且可編輯,團隊能在變更前預測哪一個市場獲勝。

官方範例是一位加拿大買家同時符合 canada-us 與 canada-mexico,兩者同樣具體且都設定 custom.banner。新規則會選 canada-mexico,因為 handle 按 byte value 逐字比較;只含小寫字母、數字與連字號時,可近似理解為字母順序,連字號排在數字與字母之前。實作時仍不應自己發明 locale 排序或中文名稱排序,應以實際 handle 與 storefront 結果驗證。

先畫市場重疊,不要直接批次改 handle

第一步匯出或盤點所有 active Markets,記錄名稱、handle、涵蓋國家或區域、買家條件與優先邏輯。建立配對表,找出可能同時符合的 Markets,再標記是否有更具體市場會先勝出。單看 Market 名稱不足以判斷,因為名稱可以相似,實際涵蓋條件卻不同。

第二步盤點 Market metafields。至少記錄 namespace、key、資料型別、各市場的值,以及被哪些 Liquid theme、Storefront API query 或 Shopify Function 使用。高風險欄位包括促銷 banner、配送限制、退貨提示、稅費說明、B2B 條件與功能旗標;純裝飾內容的優先順序通常較低。

第三步只保留同時滿足風險條件的組合:重疊、同等具體、相同 key、不同值、且會影響顧客或結帳邏輯。這張清單才是測試範圍。不要因公告提到所有 API 版本,就推論每一個 API query 都會改;變動針對 Market metafield 的 tie-break 結果。

三種處理方案怎麼選

最穩定的方案是消除不必要的重疊。若 加拿大促銷 與 北美促銷 本來就有清楚優先關係,可建立更具體的市場或重整條件,讓業務規則由市場結構表達,而不是依 handle 決勝。這適合政策、價格或配送限制等不能靠偶然排序的內容,但要先確認 Markets 其他功能是否也會受到結構調整影響。

第二種是保留重疊、統一 metafield 值。若多個市場對同一欄位本來就應顯示相同內容,把值收斂到一致能消除 tie-break 差異。若內容應由共用來源管理,也可評估把資料移到較高層的 metaobject 或商店設定,再由市場只保存必要覆寫;實際可行性仍要依 theme 與 API 架構測試。

第三種是刻意利用 handle 排序決勝。這只適合團隊能清楚文件化、測試且接受 handle 成為業務規則的一部分。不要為了讓某市場排序在前就使用看不懂的前綴,因為 handle 也會進入維運與整合。若採用此方案,必須在內容發布流程標示「修改 handle 可能改變重疊市場顯示」,並保存修改前後對照。

Theme、Headless 與 Functions 要分開驗收

Liquid theme 應以不同國家、語言與顧客情境預覽 localization.market.metafields 的輸出,確認 banner、條款與功能開關。不要只看 admin 中的值;真正重要的是買家 context 下解析到哪一個 Market。

Headless storefront 使用 Storefront API 的 Market.metafield 或 Market.metafields 時,要固定測試 query、country context 與期望值,並檢查 CDN 或應用快取 key 是否包含市場資訊。若快取只按 URL,正確解析出的市場內容仍可能被另一地區的 response 覆蓋。部署前清理必要快取,並讓測試直接驗證 API response 與頁面輸出。

Shopify Functions 若依 market metafield 做配送、折扣或其他決策,風險比文案更高。建立輸入 fixture,涵蓋每個重疊市場與邊界國家,驗證新規則下的輸出。不要只跑單元測試中的單一 Market;真正會出問題的是同等具體的多重匹配。發布時觀測 Function error、結帳轉換與客服異常,但不要把自然波動直接歸因於這次變更。

安全調整與回滾步驟

先在 development store 或可控的 theme preview 重建市場結構與 metafields,保存每個測試買家 context 的舊值與新值。確認 Shopify 通知中的套用範圍與時間,再安排內容、開發與電商營運共同審查。若要修改 handle 或市場條件,先列出受影響的 theme、Functions、報表、URL、第三方 App 與內部文件,不要把 handle 當成只有 admin 看得到的標籤。

正式調整採小步變更:一次處理一組重疊市場,發布後從 Storefront API、Liquid 頁面與結帳情境各驗證一次。保留原 handle、metafield 值、theme version 與 Function version,並記錄何時改動。若結果不符預期,回滾應恢復完整的一組設定,而不是只改回 banner 文案,避免程式邏輯與內容狀態不同步。

長期來看,建立 Market metafield registry:每個 key 都要有 owner、用途、資料型別、預設值、允許覆寫的市場、重疊時的期望勝者與測試案例。新增或修改 Market 時,自動或人工檢查它和既有市場的重疊以及不同值。這比等 Shopify 聯絡後才逐頁查看,更能降低跨境內容漂移。

這次變更的好處是把不可見的「最近更新」改成可預測的 handle,但可預測不等於符合業務意圖。跨境商店應先找出真正有重疊且值不同的欄位,優先處理配送、政策與結帳相關邏輯;沒有落入條件的商店則不必為了公告大改架構。以買家 context 做端到端驗證,才是判斷是否受影響的可靠方式。