UI Extensions / Bundle Size

UIエクステンションのバンドルサイズ上限と例外申請フォームの受付開始

64KB制限を超えたExtensionは申請で審査対応可能。ただし2026年10月1日までに対応必須。

通常UI Extension上限 64 KBフルページ(顧客)上限 128 KB超過時例外申請フォームへ

API バージョン 2025-10 以降を使用するUI extensionに対し、圧縮済みJavaScriptバンドルの上限が設定されました。上限を超過する場合は専用フォームで審査申請が可能ですが、2026年10月1日以降に引き続きデプロイ可能な状態を維持するには、すべての既存UI extensionがAPIバージョン 2026-01 以降を使用している必要があります。

1バンドルサイズ制限の詳細:Before / After 図解

API バージョン適用によるバンドル制限の変化BEFORE (〜2025-07)明示的なサイズ上限なし大きなライブラリも同梱可能翻訳ファイルをバンドルに含める重複依存関係が混入しやすい→ パフォーマンス課題の温床にAFTER (2025-10〜)通常Extension: 上限 64 KBフルページ(顧客アカウント): 128 KB超過時 → 最適化 or 例外申請ネイティブローカライズAPIを推奨→ パフォーマンス改善・審査あり

2例外申請の流れ

shopify appbuild 実行→minifiedバンドル +esbuildメタファイル取得→例外申請フォームに提出→Shopifyが審査(承認 or 却下)
承認される可能性あり

最適化後もバンドルサイズ削減が構造的に困難な場合

却下される理由
  • 重いライブラリの同梱
  • 依存関係の重複
  • 翻訳ファイルのバンドル内同梱
期限

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 以降が必須 期限あり
UI extensionのバンドルサイズ上限(通常64KB・フルページ128KB)への対応と、2026年10月1日までのAPIバージョン2026-01以降への更新を今すぐ計画することで、Shopifyストアの表示パフォーマンス向上とデプロイ継続性を両立できます。

Source: https://shopify.dev/changelog/request-a-bundle-size-exception-for-existing-ui-extensions | 公開日: 2026年9月17日