Skip to main content

Shopify Winter '26 版本：完整開發者指南

Shopify Winter '26 版本（2026 年 1 月）是 Shopify 歷史上最大的平台更新，包含 150+ 項新功能和改進。本指南按影響領域分類，詳細解析所有對開發者重要的內容。

為什麼這個版本不同

Winter '26 標誌著 Shopify 全面轉向代理商務——AI 代理（不僅僅是人類）將代表消費者瀏覽、協商和購買的理念。這個版本中的每一個主要功能要麼啟用 AI 代理，要麼是在 AI 輔助下建構的。作為開發者，理解這一轉變對於在 2026 年及以後建構相關的 App 至關重要。

AI 與代理商務​

Winter '26 的核心。Shopify 押注下一波電子商務成長來自 AI 驅動的購物代理。

Shopify Sidekick（重大升級）​

Sidekick，Shopify 為商家內建的 AI 助手，獲得了自推出以來最重大的升級。

新功能：

  • Sidekick Extensions API —— 第三方 App 現在可以為 Sidekick 擴展自訂功能。當商家要求 Sidekick「優化我的電子郵件活動」時，你的 App 可以處理它。
  • Sidekick Actions —— Sidekick 現在可以執行多步驟工作流程：建立產品、設定折扣、在單次對話中安排行銷活動。
  • 情境感知 —— Sidekick 現在會讀取商店分析、最近的訂單和客戶資料，以提供情境化的建議。
  • 商家核准流程 —— Sidekick 在執行前會提出行動建議並等待商家確認。對於信任至關重要。

開發者影響：

  • 新的 Sidekick Extension Points 供 App 開發者使用
  • sidekick.action.propose 和 sidekick.action.execute API 端點
  • 透過 Partner Dashboard 的自訂工具註冊
# Register a Sidekick Extension
mutation sidekickExtensionCreate {
  sidekickExtensionCreate(input: {
    title: "Email Campaign Optimizer"
    description: "Analyzes store data and optimizes email campaigns"
    actionDefinitions: [
      {
        name: "optimize_campaign"
        description: "Optimize an email campaign based on store analytics"
        inputSchema: "{ ... }"
      }
    ]
  }) {
    sidekickExtension { id }
    userErrors { field message }
  }
}
Sidekick Extensions 處於開發者預覽階段

截至 Winter '26，Sidekick Extensions 可供已批准的 Partner 使用。請透過 Partner Dashboard 的「Beta Programs」申請。

Catalog API（新功能）​

Catalog API 讓 AI 代理和外部系統能以結構化的機器可讀格式與商店的產品目錄互動。

關鍵功能：

  • 為 AI 消費優化的結構化產品資料
  • 跨產品屬性的語義搜尋
  • 具有即時準確性的價格和庫存查詢
  • 產品比較和推薦支援
  • 多語言和多幣別支援

重要性： 傳統產品 API 返回為人類建構的前端設計的資料。Catalog API 返回結構化資料，讓 AI 代理能夠理解和推理。

# Catalog API: semantic product search
query {
  catalog {
    productSearch(
      query: "comfortable running shoes for flat feet under $150"
      semanticMatch: true
      limit: 10
    ) {
      results {
        product {
          id
          title
          semanticDescription
          priceRange { minVariantPrice { amount currencyCode } }
          attributes { key value confidence }
        }
        relevanceScore
      }
    }
  }
}

AI 代理 Checkout Kit​

一個新的 SDK，讓 AI 購物代理能代表消費者完成購買。

組成：

  • 代理驗證 —— 代表使用者的 AI 代理的安全身份驗證
  • 購物車組裝 —— 具有代理優化驗證的程式化購物車建立
  • 支付委託 —— 代理可使用的 Token 化支付方式，無需查看卡片資訊
  • 同意框架 —— 代理發起購買前的使用者核准流程

開發者影響： 如果你正在建構 AI 購物助手、聊天機器人或語音商務，這是你的主要整合點。

SimGym​

用於測試 AI 代理與 Shopify 商店互動的模擬環境，不會影響真實資料或觸發真實支付。

功能：

  • 用於代理測試的沙盒商店副本
  • 模擬支付處理
  • 可設定的庫存、定價和運送情境
  • 代理決策的效能基準測試
  • 代理策略的 A/B 測試

使用案例：

  • 在連接到真實商店之前測試你的 AI 購物代理
  • 在不同的商店設定下對代理效能進行基準測試
  • 在模擬的電子商務互動上訓練自訂模型

Tinker App​

一個新的 Shopify App，用於在管理後台直接原型設計和實驗 AI 驅動的商店功能。

功能：

  • Sidekick Extensions 的視覺化提示建構器
  • 用你商店的即時資料測試 AI 代理互動
  • 預覽 AI 生成的產品描述在主題上的外觀
  • 實驗動態定價演算法
  • 原型設計自訂推薦引擎

開發者平台​

Shopify Dev MCP Server​

用於 AI 輔助 Shopify 開發的官方 MCP Server。請參閱我們的詳細指南。

Winter '26 新增：

  • 完整的 API 2026-01 Schema 支援
  • JavaScript 和 Rust 的 Shopify Functions 腳手架
  • Checkout Extension 文件和範例
  • 改善的搜尋相關性和回應品質
  • 新的 validate_graphql 工具用於查詢驗證

Shopify Functions（正式發布）​

Shopify Functions 從開發者預覽版升級為 正式發布（Winter '26）。

支援的 Function API：

Function 類型用途狀態
Delivery Customization自訂運費和選項GA
Payment Customization自訂支付方式篩選GA
Discount自訂折扣邏輯GA
Cart Transform修改購物車內容（捆綁、贈品）GA
Fulfillment Constraints限制出貨選項GA
Order Routing Location Rule自訂出貨路由GA
Validation自訂結帳驗證GA
GateToken 門控商務GA

Winter '26 新增：

  • JavaScript 支援（與 Rust 並列，使用 Javy 執行時）
  • 增加的執行限制 —— 5MB 記憶體，10ms 執行時間
  • 網路存取（有限）用於外部 API 呼叫
  • 持久儲存透過 Function 輸入中的 Metafield 讀取存取
  • 測試框架使用 shopify app function test
// Example: Delivery Customization Function (JavaScript)
// @ts-check
import { DeliveryCustomization } from "@shopify/shopify-functions";

export default function deliveryCustomization(input) {
  const operations = [];

  // Block express shipping for oversized items
  for (const delivery of input.cart.deliveryGroups) {
    for (const option of delivery.deliveryOptions) {
      const hasOversizedItem = input.cart.lines.some(line =>
        line.merchandise?.product?.hasTag("oversized")
      );

      if (hasOversizedItem && option.title.includes("Express")) {
        operations.push({
          hide: { deliveryOptionHandle: option.handle }
        });
      }
    }
  }

  return { operations };
}

主題編輯器大改版​

線上商店編輯器進行了重大重新設計：

  • 即時協作編輯 —— 多位團隊成員可以同時編輯主題
  • 版本歷史 —— 完整的變更歷史，包含差異對比和回滾功能
  • AI 輔助內容 —— 在編輯器中生成 Section 內容、替代文字和文案
  • 元件庫 —— 拖放預建元件（Hero Section、產品網格等）
  • 效能預算 —— 編輯時的即時效能評分

開發者儀表板​

新的集中式 Shopify App 開發者儀表板：

  • API 使用分析 —— 即時監控 API 呼叫量、錯誤率和延遲
  • Webhook 可靠性 —— 按主題追蹤 Webhook 傳遞成功率
  • App 效能 —— 載入時間、錯誤率和商家滿意度指標
  • 營收分析 —— MRR、流失、安裝/卸載趨勢
  • 合規狀態 —— GDPR、資料存取和安全要求追蹤

Tangle（內部框架，現已文件化）​

Shopify 公開記錄了 Tangle，他們用於建構複雜、型別安全的 GraphQL API 的內部框架。雖然外部開發者無法直接使用，但理解 Tangle 有助於你更有效地使用 Shopify 的 API。

關鍵概念：

  • 每個 Shopify GraphQL 型別都由 Tangle 模型支持
  • Mutation 遵循一致的模式：input → model → output + userErrors
  • Connection（分頁）在所有型別中標準化
  • 存取範圍直接對應到 Tangle 授權規則

OAuth 憑證升級​

Shopify 的 OAuth 系統獲得了顯著改進：

  • Proof Key for Code Exchange (PKCE) —— 所有新 App 必須使用
  • 輪換 Refresh Token —— 自動 Token 輪換以增強安全性
  • 範圍化 Access Token —— 每次會話只請求所需的範圍
  • Token 內省端點 —— 無需商店往返即可驗證 Token 有效性
  • 離線/線上 Token 的清晰說明 —— 更好的 Token 類型文件和工具

API 版本 2026-01​

2026 年的第一個 API 版本帶來：

新的型別和欄位：

  • CatalogProduct —— 為 AI 代理優化的產品表示
  • SidekickExtension —— 註冊和管理 Sidekick Extensions
  • FunctionRunResult —— 改善的 Function 執行結果型別
  • CheckoutBranding —— 擴展的結帳客製化選項

從 2025-10 的破壞性變更：

  • Product.images 已棄用，改用 Product.media
  • Order.shippingLine 移至 Order.shippingLines（複數）
  • orders/create 和 orders/update 的 Webhook 載荷格式變更
  • InventoryLevel.available 已棄用，改用 InventoryLevel.quantities

棄用：

  • REST Admin API 產品圖片端點（使用 GraphQL productMedia Mutation）
  • ScriptTag 資源（由 WebPixel 取代）
  • 舊版結帳客製化（使用 Checkout UI Extensions）
API 遷移時間表
  • 2026-01 於 2026 年 1 月發布
  • 2025-04 將於 2026 年 4 月終止
  • 2025-07 將於 2026 年 7 月終止

如果你使用的是 2025-04 或更早版本，請立即開始遷移。

商店與主題​

Rollouts​

主題變更的新部署功能：

  • 階段性部署 —— 先將主題變更推送給一定比例的流量
  • 自動回滾 —— 如果錯誤率飆升，變更會自動還原
  • A/B 測試整合 —— 根據轉換指標比較主題版本
  • 排程部署 —— 在特定日期/時間排隊主題變更

每個產品 2,048 個變體​

變體限制從 100 增加到 每個產品 2,048 個。

開發者影響：

  • 產品表單和變體選擇器需要處理更大的選項矩陣
  • 庫存管理 UI 需要變體列表的分頁
  • 變體的 GraphQL 查詢應使用帶游標分頁的 Connection
  • 每個變體的 Metafield 管理需要批量操作模式
# Paginating through variants of a high-variant-count product
query {
  product(id: "gid://shopify/Product/123") {
    variants(first: 50, after: "cursor") {
      edges {
        node {
          id
          title
          price
          inventoryQuantity
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}

未列出產品​

產品現在可以被標記為未列出 —— 可透過直接連結存取，但不會在搜尋、Collection 或網站地圖中顯示。

使用案例：

  • 特定客戶群的專屬產品
  • 與網紅分享的預發布頁面
  • 僅透過自訂入口存取的 B2B 產品
  • 限量分發的活動專屬商品

API：

mutation {
  productUpdate(input: {
    id: "gid://shopify/Product/123"
    status: ACTIVE
    publishedScope: UNLISTED
  }) {
    product { id status }
    userErrors { field message }
  }
}

行動主題生成器​

一個 AI 驅動的工具，可以從你現有的桌面主題生成行動優化的主題變體：

  • 自動的小螢幕佈局調整
  • 觸控目標大小優化
  • 圖片調整大小和藝術指導
  • 導航簡化
  • 行動網路的效能優化

商務與支付​

產品網路​

一個新的 B2B 功能，允許商店在 Shopify 商家網路中共享產品目錄：

  • 供應商發布產品到網路
  • 零售商可以瀏覽並將產品加入自己的商店
  • 庫存在網路中即時同步
  • 由供應商設定的定價和利潤規則
  • 由供應商處理的出貨（代發貨模式）

開發者影響： 網路管理、目錄共享和跨商店操作的新 API 端點。

ACH 支付​

**ACH（自動清算所）**支付現在透過 Shopify Payments 支援：

  • 比信用卡更低的交易費用（0.5% 對比 2.9%）
  • B2B 商家可以接受銀行對銀行的支付
  • 訂閱的週期性支付支援
  • 3-5 個工作天結算

POS 大改版​

Shopify POS 進行了重大更新：

  • 統一 API —— POS 和線上商店使用相同的庫存、訂單和客戶 API
  • POS UI Extensions —— 使用與線上 Checkout 相同的 Extension 框架建構自訂 POS 體驗
  • Tap to Pay —— 透過 iPhone 和 Android 裝置的 NFC 支付
  • 員工權限 API —— 程式化管理 POS 員工角色和權限

Uber Direct 整合​

與 Uber Direct 的原生整合，用於當日本地配送：

  • 結帳時的即時配送報價
  • 訂單出貨時自動派遣司機
  • 商家和客戶的即時追蹤
  • 自訂配送工作流程整合的 API

基礎設施​

Oxygen V2​

Shopify 的 Hydrogen 店面託管平台獲得了重大升級：

  • Edge 運算 —— 在 300+ 個全球 Edge 節點的伺服器端渲染
  • 串流 SSR —— React Server Components 搭配串流以獲得更快的 TTFB
  • 自動擴展 —— 從 0 到數百萬請求的自動擴展
  • 環境分支 —— 每個 Git 分支的預覽部署
  • 日誌串流 —— 即時日誌輸出到你的監控平台

Webhook 可靠性改善​

  • 保證傳遞 搭配可設定的重試策略（最長 72 小時）
  • 死信佇列 —— 失敗的 Webhook 儲存供手動檢查
  • 開發者儀表板中的傳遞指標
  • Webhook 版本控制 —— 載荷格式鎖定到你的 API 版本
  • 透過 GraphQL 的批量 Webhook 管理

GraphQL 成本改善​

  • 常見查詢（products、orders、customers）的降低成本
  • 平行查詢執行 —— 在單一請求中執行多個獨立查詢
  • 查詢複雜度估算器 —— 執行前檢查成本的新 API 端點
  • 突發速率增加 —— Shopify Plus 商店的更高突發限制

遷移清單​

對於更新 App 以適應 Winter '26 的開發者：

高優先級​

  • 更新到 API 版本 2026-01
  • 從 Product.images 遷移到 Product.media
  • 將 Order.shippingLine 更新為 Order.shippingLines
  • 為 OAuth 流程實作 PKCE
  • 在 UI 中處理 2,048 變體的產品

中優先級​

  • 探索你 App 類別的 Sidekick Extensions
  • 針對 Catalog API 測試 AI 代理相容性
  • 更新 Webhook 處理以適應新的載荷格式
  • 如適用，將 ScriptTag 遷移到 WebPixel

低優先級（但值得探索）​

  • 評估 Shopify Functions 是否可取代目前在你 App 伺服器中的自訂邏輯
  • 在 SimGym 中測試你 App 的代理相容性
  • 設定開發者儀表板進行監控
  • 實驗行動主題生成器

時間表​

日期事件
2026 年 1 月 15 日Winter '26 版本宣布
2026 年 1 月 15 日API 2026-01 發布
2026 年 2 月 1 日Sidekick Extensions 開發者預覽開放
2026 年 3 月 1 日Catalog API 公開測試版
2026 年 4 月 1 日API 2025-04 終止
2026 年 4 月 15 日Functions JavaScript 執行時正式發布
2026 年 6 月Summer '26 版本（預計）

資源​