API バージョン 2026-04 で、checkout / customer account UI 拡張から checkout metafields の読み書きが「削除」された。古いバージョンで使っている拡張は 2026-04 へのアップグレードと移行が必須。
checkout / customer account UI 拡張での checkout metafields の読み取り・書き込み。2026-04 では使えない。
cart metafields に置き換える。チェックアウト中のデータ保持はこちら。
order metafields に置き換える。注文後・アカウント画面のデータ参照はこちら。
| 項目 | cart metafields | order metafields |
|---|---|---|
| 使う拡張 | Checkout UI 拡張 | Customer Account UI 拡張 |
| 主な役割 | チェックアウト進行中のデータ保持・読み書き | 注文に紐づくデータの参照・読み書き |
| 旧 checkout metafields との関係 | Checkout UI 拡張での代替 | Customer Account UI 拡張での代替 |
| 公式移行ガイド | 「Migrate to cart metafields in checkout UI extensions」 | 「Migrate to order metafields in customer account UI extensions」 |
Checkout UI 拡張が cart metafields に書き込む。
order metafield 定義の設定により、値が order 側へ自動コピーされる。
Customer Account UI 拡張や注文データ側で order metafields として扱える。
checkout / customer account UI 拡張で checkout metafields を読み書きしている箇所を洗い出す。
Checkout UI 拡張 → cart metafields、Customer Account UI 拡張 → order metafields に書き換える。
移行後に拡張を 2026-04 へアップグレード。古いバージョンを使い続けている場合は必須。
2026-04 で checkout metafields の読み書きは既に削除。猶予を当て込んだ先送りは不可。バージョンアップ前に移行を完了させる。
Checkout UI → cart metafields、Customer Account UI → order metafields。同じ「checkout metafields」でも置換先が 2 系統に分かれる点に注意。
order metafield 定義の新機能で、注文作成時に cart の値を order へ自動複写できる。受け渡しコードの自作を減らせる。
cart 用・order 用の 2 本の移行ガイドが用意されている。具体的な API 仕様・コード差分は本文に記載なしのため、ガイドを参照する。
チェックアウト中に必要なデータは cart、注文確定後に残すべきデータは order、という役割分担で設計し直すと自然に収まる。両方で必要なものは「cart に書いて注文作成時に order へ自動コピー」が定石パターンになる。