Skip to content

[WIP] Support the ui_extension_bundle_size_exception capability - #8335

Draft
igor10k wants to merge 1 commit into
mainfrom
i10k/extension_size_exception_scopes
Draft

[WIP] Support the ui_extension_bundle_size_exception capability#8335
igor10k wants to merge 1 commit into
mainfrom
i10k/extension_size_exception_scopes

Conversation

@igor10k

@igor10k igor10k commented Aug 14, 2026

Copy link
Copy Markdown
Collaborator

Why

Shopify can grant specific apps an exception to the UI extension bundle size limit, applied per extension through the ui_extension_bundle_size_exception capability in shopify.extension.toml. The capabilities schema strips unknown keys, so without this change the capability never reaches the extension configuration deployed to Shopify and the exception can't take effect. Enforcement is entirely server-side; the exception is granted by Shopify directly to the affected apps.

What

  • Adds ui_extension_bundle_size_exception as an optional boolean to CapabilitiesSchema.

Testing

  1. In a UI extension's shopify.extension.toml, add:
    [extensions.capabilities]
    ui_extension_bundle_size_exception = true
  2. Run shopify app deploy (or inspect the module config sent to App Management) and verify the capability is present in the extension's configuration instead of being stripped.
  3. Unit: pnpm vitest run src/cli/models/extensions/specifications/ui_extension.test.ts in packages/app.

Adds ui_extension_bundle_size_exception to the extension capabilities
schema so extensions declaring it in shopify.extension.toml include it
in the configuration deployed to Shopify. The backend raises the Remote
DOM compressed bundle size limit for extensions declaring this
capability when the app has been granted a bundle size exception
approval scope by Shopify. Intentionally undocumented: grants are shared
directly with partners who requested an exception.
@github-actions github-actions Bot added the Area: @shopify/app @shopify/app package issues label Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area: @shopify/app @shopify/app package issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant