UIエクステンションのバンドルサイズ上限と例外申請フォームの受付開始
64KB制限を超えたExtensionは申請で審査対応可能。ただし2026年10月1日までに対応必須。
API バージョン 2025-10 以降を使用するUI extensionに対し、圧縮済みJavaScriptバンドルの上限が設定されました。上限を超過する場合は専用フォームで審査申請が可能ですが、2026年10月1日以降に引き続きデプロイ可能な状態を維持するには、すべての既存UI extensionがAPIバージョン 2026-01 以降を使用している必要があります。
1バンドルサイズ制限の詳細:Before / After 図解
2例外申請の流れ
最適化後もバンドルサイズ削減が構造的に困難な場合
- 重いライブラリの同梱
- 依存関係の重複
- 翻訳ファイルのバンドル内同梱
2026年10月1日以降もデプロイ継続するには 2026-01以降のAPIバージョン使用が必須
3業務に活かせる具体ユースケース
- 課題
- 既存のCheckout UI extensionが最適化後も64KBを超えてしまう
- 打ち手
-
shopify app buildでminifiedバンドルとesbuildメタファイルを生成し、例外申請フォームに提出してShopifyの審査を受ける - 効果
- 構造的に避けられない重量が認められた場合に限り、上限増加が承認され引き続きデプロイ可能になる
- 技術メモ
- メタファイルはesbuildのbundle解析に使われるため、ビルド時に
--metafileオプションを有効化しておくこと
- 課題
- 多言語対応のために翻訳ファイルをバンドル内に含めており、サイズが肥大化している
- 打ち手
- Shopifyが提供するネイティブローカライズAPIに移行し、翻訳データをバンドルから切り離す
- 効果
- バンドルサイズの大幅削減が期待でき、例外申請なしで64KB制限をクリアできる可能性が高まる
- 技術メモ
- ネイティブローカライズAPIへの移行は、公式ドキュメント「Optimize bundle size for UI extensions」を参照のこと
- 課題
- フルページの顧客アカウントExtensionが機能追加で段階的に肥大化してきた
- 打ち手
- フルページExtensionは128KBまで利用可能な点を活用しつつ、重複依存関係の除去・ツリーシェイキングを実施してサイズを最小化する
- 効果
- 128KBの範囲内に収めることで例外申請不要でデプロイを継続でき、2026年10月の期限に間に合う
- 技術メモ
- APIバージョンを2026-01以降に更新することも同時に対応が必要。バージョン更新漏れがあると2026年10月1日以降にデプロイ不可となる
4技術者が押さえるべきポイント
| 観点 | 詳細 | ステータス |
|---|---|---|
| 対象APIバージョン | 2025-10 以降のUI extensionに適用 | 適用中 |
| 通常Extensionの上限 | 圧縮済みJSバンドル 64 KB | 制限あり |
| フルページExtensionの上限 | 顧客アカウント向けフルページのみ 128 KB | 制限あり |
| 申請コマンド |
shopify app build → minifiedバンドル + esbuildメタファイルを取得して提出 |
手動対応 |
| 却下条件 | 重いライブラリ同梱・依存重複・翻訳ファイルのバンドル内同梱は却下対象 | 要改善 |
| デプロイ継続の必須条件 | 2026年10月1日以降はAPIバージョン 2026-01 以降が必須 | 期限あり |
Source: https://shopify.dev/changelog/request-a-bundle-size-exception-for-existing-ui-extensions | 公開日: 2026年9月17日






Share:
automaticDiscountsクエリ廃止と移行ガイド
在庫入荷APIにキャンセル受領アクション追加