Skip to content

Support the bundle_size_exception capability - #8335

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

Support the 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 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 bundle_size_exception as an optional boolean to CapabilitiesSchema.

Testing

  1. In a UI extension's shopify.extension.toml, add:
    [extensions.capabilities]
    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.

@github-actions github-actions Bot added the Area: @shopify/app @shopify/app package issues label Aug 14, 2026
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.
@igor10k
igor10k force-pushed the i10k/extension_size_exception_scopes branch from cb31b48 to 8e689d6 Compare August 18, 2026 20:00
@igor10k igor10k changed the title [WIP] Support the ui_extension_bundle_size_exception capability Support the ui_extension_bundle_size_exception capability Aug 18, 2026
@igor10k
igor10k marked this pull request as ready for review August 18, 2026 20:01
@igor10k
igor10k requested a review from a team as a code owner August 18, 2026 20:01
Copilot AI lite review requested due to automatic review settings August 18, 2026 20:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds support for the bundle_size_exception UI extension capability by extending the CLI’s capabilities schema so the key is not stripped during configuration parsing and is included in the deploy payload.

Changes:

  • Add bundle_size_exception?: boolean to CapabilitiesSchema so it is preserved in extension configuration.
  • Add a unit test ensuring bundle_size_exception appears in the UI extension deploy config.
  • Add a changeset to publish the capability support as a user-facing change.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
packages/app/src/cli/models/extensions/specifications/ui_extension.test.ts Adds a deploy-config unit test verifying bundle_size_exception is preserved and sent.
packages/app/src/cli/models/extensions/schemas.ts Extends CapabilitiesSchema with the new optional boolean capability.
.changeset/spicy-crabs-bundle.md Declares a version bump to release support for the new capability.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@igor10k igor10k changed the title Support the ui_extension_bundle_size_exception capability Support the bundle_size_exception capability Aug 19, 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.

2 participants