これまで Checkout Profile API と Checkout Branding API に分かれていた設定とブランディングが、API version 2026-04 で1つのAPIに集約。共有デザイントークンで一度設定すれば3つの画面に一貫して適用できる。Shopify Plus 限定。
Checkout Profile API と Checkout Branding API を別々に扱い、対象はチェックアウトが中心。両APIとも非推奨(deprecated)になった。
設定とブランディングの全機能を1つのAPIに統合。チェックアウト・顧客アカウント・サインインを横断して一貫したブランド適用ができる。
designTokens / components で全体のブランドを一括定義し、surfaces.checkout / surfaces.customerAccounts / surfaces.signIn で各画面の差分だけ上書きする。共有の designTokens と components でブランドを一度設定すれば、チェックアウト・顧客アカウント・サインインに一貫して適用。section styles を顧客アカウントのページにも展開できる。
surfaces.checkout / surfaces.customerAccounts / surfaces.signIn 配下で、ロゴ・色・section styles を画面ごとにピンポイントで上書きできる。
main / header / orderSummary などのセクションに HEX 値やパレット色を直接設定。限られた color schemes へのマッピングは不要に。最大20色のパレットを保存して参照できる。
マーケット(market)ごとに固有のブランディング設定を当てられる。国・地域ごとにページの見た目を出し分けられる。
| 項目 | 従来 | Checkout And Accounts Configuration API |
|---|---|---|
| API の本数 | 2本 Checkout Profile API + Checkout Branding API | 1本 に統合 |
| 対象画面 | チェックアウト中心 | 3面 チェックアウト・顧客アカウント・サインイン |
| section styles | チェックアウトのみ | 顧客アカウントのページにも適用可 |
| 色の指定方法 | 限られた color schemes へのマッピング | HEX値/パレット色をセクションに直接指定 |
| マーケット別ブランディング | — | 対応 market ごとに設定 |
| 旧API のステータス | — | 非推奨 旧2APIは deprecated |
このAPIは Shopify Plus マーチャント専用。Plus 以外のプランでは利用できない。
API version 2026-04 から利用可能。これより前のバージョンでは旧API(非推奨)を使うことになる。
Checkout Profile API と Checkout Branding API はともに deprecated。新規実装は統合APIで組む。既存コードは移行対象になる(移行手順・終了日の記載はなし、要ドキュメント確認)。
共有の designTokens / components を土台に、surfaces.* で差分だけ上書きする設計。共有を太く、上書きを薄く保つと運用が破綻しにくい。
限られた color schemes に割り当てる必要がなくなり、main / header / orderSummary 等に HEX やパレット色を直接指定。意図した色がそのまま当たる。
最大20色のパレットを定義し、各所からは値ではなく参照で指定。パレット側を1回更新すれば参照先が一斉に変わる。CSS 変数/デザイントークンと同じ感覚で運用できる。
market ごとに固有のブランディング設定を当てられるため、国・地域別の見た目の出し分けも同じAPIの中で完結する。多国展開のブランド管理を1本のAPIに寄せられる。
designTokens / components でブランドを一括定義し、3面に同じトーンを適用。section styles を顧客アカウントにも展開。surfaces.* で上書き。Shopify Plus 限定・API version 2026-04 以降。