Polaris Web Components移行ガイド公開：Checkout & カスタマーアカウント対応

UI EXTENSIONS

Polaris Web Components移行ガイド公開
Checkout & カスタマーアカウント対応

API 2025-10以降への移行を60以上のコンポーネント別ガイドでサポート

このガイドはCheckout・カスタマーアカウントUIエクステンションの開発者を対象に、2026年5月13日に公開されました。API 2025-10以降ではPolaris Web Componentsがデフォルトとなるため、それ以前のバージョンを使用している拡張機能は移行対応が必要です。

課題: 既存のCheckoutカスタマイズがReact拡張APIで構築されており、新しいAPIバージョンへの追随が遅れている
打ち手: 公式の「Checkout UI extensions migration guide」を参照し、ReactコンポーネントをPreact＋Polaris Web Componentsへ段階的に置き換える
効果: API 2025-10以降の最新機能を活用でき、将来的なバージョンアップへの対応工数を削減できる
技術メモ: Buttonやcheckbox、TextFieldなど60以上のコンポーネント別移行ページが用意されているため、個別コンポーネント単位で安全に移行できる

課題: カスタマーアカウントUIエクステンションでcheckout metafieldsを利用しており、仕様変更への対応方法が不明
打ち手: 移行ガイドに含まれる「checkout metafields → cart metafields」の移行手順に従い、データ参照先を切り替える
効果: metafieldsの参照ロジックを最新仕様へ統一でき、データ取得の一貫性と保守性が向上する
技術メモ: 元記事ではcheckout metafieldsからcart metafieldsへの移行指示が明記されているが、具体的なAPI差異は公式ドキュメントで要確認

課題: カスタマーアカウント画面に独自UIを実装しているが、Polaris Web Componentsへの移行パスが把握できていない
打ち手: 「Customer Account UI extensions migration guide」を起点に、global shopify objectへの切り替えおよびPolaris Web Components対応を進める
効果: デザインの一貫性がShopify標準に沿ったものとなり、今後のShopifyアップデートへの追従コストを低減できる
技術メモ: 移行ガイドはBanner・View等のレイアウト系コンポーネントも対象に含む。対象コンポーネントの全量は公式ガイドページで確認すること

対象APIバージョン

API 2025-10以降でPolaris Web Componentsがデフォルト。それ以前のバージョンを使用している拡張機能が移行対象。

フレームワーク移行

ReactまたはJavaScriptベースのExtension APIからPreact + global shopify objectへの切り替えが必要。Preact採用により軽量化が期待される。

60以上のコンポーネント対応

Button / Checkbox / TextField / Banner / View など60超のコンポーネント別移行ページが公開済み。コンポーネント単位で確認・対応が可能。

metafields仕様変更

checkout metafieldsからcart metafieldsへの移行手順がガイドに含まれる。データ層の変更が伴うため、動作確認を丁寧に行うこと。

移行ガイドの起点

Checkout UI extensions移行ガイドとCustomer Account UI extensions移行ガイドの2系統が独立して提供されている。用途に応じて参照先を選ぶこと。

確認項目	内容	ステータス
対象API	2025-10より前のバージョンを使用する拡張機能	要対応
フレームワーク	React/JS → Preact + global shopify object	ガイドあり
コンポーネント数	60以上のコンポーネント別ページ	公開済み
metafields	checkout metafields → cart metafields	要移行
対象拡張機能	Checkout UI / Customer Account UI	両対応