記事のサマリー（TL;DR）
shopify.extension.versionが、実行中の拡張機能のバージョンを返す新しいフィールドとして追加されました。- この値はDev Dashboardの「Versions」ページに表示される名前、および
shopify app deploy実行時に選択する名前と同じものです。 - 対象はAPI version 2026-10をターゲットとするPOS UI拡張機能のみで、それより前のAPIバージョンをターゲットとする拡張機能には影響しません。
詳細
変更内容
shopify.extension.version は、実行中の拡張機能のバージョンを返します。これはDev Dashboardの「Versions」ページに表示される名前、および shopify app deploy を実行した際に選択する名前と同一です。この値は不透明な名前（opaque name）であり、バージョン番号ではないため、ソートではなく等価比較で扱う必要があります。また、拡張機能がローカル開発サーバーから実行されている場合、この値は undefined になります。
対象範囲
このフィールドは、API version 2026-10をターゲットとするPOS UI拡張機能で利用できます。それより前のAPIバージョンをターゲットとする拡張機能には変更はありません。
変更の背景
POSは拡張機能のバンドルをキャッシュし、オフラインで実行することがあります。このフィールドは、開発者が加盟店のデバイス上でどの公開ビルドが実行されているかを識別する際に役立つとされています。
対応が必要な内容
既存の拡張機能について、対応は不要です。このフィールドを利用するには、API version 2026-10をターゲットにする必要があります。また、ローカル開発サーバーからテストする際は、値が undefined になる点を考慮する必要があります。
関連ドキュメント
POS UI Extensions API、version 2026-10