Quick answer
Shopify UI extensions on API version 2025-10 or later have a 64 KB compressed JavaScript limit per extension; full-page customer account extensions can use up to 128 KB. Build the app, inspect the bundle, remove avoidable dependencies and bundled translations, and request an exception only if the remaining weight is unavoidable.
On this page
Why this becomes a deployment problem
Bundle size is a platform constraint, not a performance suggestion. An extension can work locally and still fail deployment because its compiled bundle crosses the limit.
This matters during current API upgrades too. Shopify requires existing UI extensions in an app to use API version 2026-01 or later for the app to remain deployable after October 1, 2026.
Practical implementation details
Start with the production artifact rather than the size of your source folder. Run shopify app build. If the extension is too large, inspect the minified bundle and esbuild metafile to identify the largest contributors.
Look first for causes Shopify explicitly calls avoidable: heavy libraries, duplicate dependencies, and translations bundled into JavaScript instead of native localization APIs. A small local utility can cost less than a general-purpose package.
Do not remove required validation or business logic just to hit the number. Shopify provides an exception process for existing UI extensions that remain over the limit after reasonable optimization.
Common misunderstanding
“If Shopify offers an exception, I can skip optimization.” No. Shopify says exception requests can be denied for avoidable bundle weight. Treat the exception as the last step.
How to test this
- Run
shopify app buildon the branch and API version you intend to deploy. - Record compressed size for each UI extension separately.
- Inspect the esbuild metafile for unexpectedly large or duplicated packages.
- Move translations to native localization and remove unnecessary dependencies.
- Build again and verify the extension is below its applicable limit.
- Retest the complete extension after optimization.
- If weight is unavoidable, prepare the minified bundle and metafile for Shopify’s exception review.
Sources and further reading
- Request a bundle size exception for existing UI extensions — Shopify developer changelog, September 17, 2026.
- Checkout UI extensions documentation.
- Shopify AI Toolkit for upgrading extensions to Polaris web components — June 11, 2026.