4.0.0

Shopify CLI 4.0.0

The release of Shopify CLI 4.0 today brings clarity to CLI versioning, the introduction of automatic updates, and the announced removal of the deprecated --force flag from shopify app deploy.

Semantic Versioning

Shopify CLI is now following semantic versioning practices. Releases with new features will be minor versions, and bug fixes will be patch versions. When required, major version releases will be used to communicate breaking changes to CLI command structure or behavior.

For more information, see our announcement of the move to SemVer.

Automatic Upgrades

Starting with Shopify CLI 4.0, Shopify CLI upgrades itself automatically using the package manager you installed it with. Auto-upgrade is skipped in CI, project-local installs, and for major version releases. Automatic upgrades can be disabled with the shopify config autoupgrade off command.

⚠️ Breaking Changes

App

• Remove the deprecated --force (-f) flag and SHOPIFY_FLAG_FORCE environment variable from shopify app deploy. Use --allow-updates for CI/CD environments, or --allow-updates --allow-deletes if you also want to allow removals. The --no-release flag continues to work and implicitly allows updates and deletes. (96281e6)
• Remove the deprecated --force (-f) flag and SHOPIFY_FLAG_FORCE environment variable from shopify app release. Use --allow-updates for CI/CD environments, or --allow-updates --allow-deletes if you also want to allow removals. Passing both --allow-updates and --allow-deletes skips the confirmation prompt (matching the previous --force behavior). (c36d5c2)
• Remove the deprecated --type (-t) flag and SHOPIFY_FLAG_EXTENSION_TYPE environment variable from shopify app generate extension. Use --template (SHOPIFY_FLAG_EXTENSION_TEMPLATE) instead. (ad69d29)
• Remove the deprecated shopify app generate schema command. Use shopify app function schema instead. (f23fe6c)
• Remove the deprecated shopify app scaffold extension command. Use shopify app generate extension instead. (ec867ef)
• Remove the deprecated top-level shopify webhook trigger alias. Use shopify app webhook trigger instead. (60d2697)
• Remove the deprecated --shared-secret flag and SHOPIFY_FLAG_SHARED_SECRET environment variable from shopify app webhook trigger. Use --client-secret (SHOPIFY_FLAG_CLIENT_SECRET) instead. (38ce793)

Theme

• Remove the deprecated shopify theme serve command. Use shopify theme dev instead. (a960ee9)

General

• Drop support for Node 20 (0c35553)

Patch Changes

App

• Fix Spawn ETXTBSY bug with multiple Functions using trampoline binaries (2520541)
• Show Local URL in dev info when no App URL is available (e4ec92b)
• Detect files added during a running dev session (f8eabc1)
• Handle modern Bun bun.lock files when cleaning up app templates so non-Bun projects do not keep stale Bun lockfiles or .gitignore entries (a7d448b)
• Fix shopify app build intermittently failing with "Source and destination must not be the same" on UI extensions when the local esbuild output directory and the bundle output directory resolve to the same path but differ as strings (e.g. due to . segments, trailing slashes, or path joining quirks). The same-path guard now normalizes both paths via resolvePath before comparison. (e94c94e)
• Fix uid being written outside the [[extensions]] block in single-entry array-of-tables TOMLs (the shape produced by shopify app init templates) (1bf342d)
• Guard app bundle uploads against oversized bundles and asset paths resolving outside the app directory (926db8b)
• Display a friendly error message instead of a stack trace when running shopify app config link --client-id=<id> against a Dev Dashboard app and the client ID does not exist (8a9c5a1)
• Hide the deprecated remix template from shopify app init --template help text and validation messages. The React Router template has replaced Remix as the supported choice. Passing --template remix continues to work for backwards compatibility. (6cb484f)
• The CLI-generated shopify.d.ts now types the shopify binding as Api & ShopifyGlobal (intersection) for UI extension targets whose .d.ts re-exports a ShopifyGlobal type. Existing consumers who access the target API via shopify.* are unaffected; new host-level APIs like shopify.addEventListener now type-check automatically for opt-in targets (e.g. POS background extensions). Targets that do not re-export ShopifyGlobal emit the same output as before. (c70e536)
• Fix unhelpful error when extension locale file has invalid UTF-8 (d5028b5)
• Fix dev and build command for web_pixel extensions (dc70080)

Theme

• Upload config/settings_schema.json before any other theme file. Fixes theme push failing on the first push when blocks or sections reference a color_palette theme setting. (1e8963e)
• Fix theme dev proxy to support SFAPI requests (8f4e546)
• Fix theme dev analytics being dropped on Ctrl+C (c6a114d)

General

• Make the autocomplete prompt feel instant when filtering against in-memory choices (67745ee)
• Also treat OPT_OUT_INSTRUMENTATION=true as an analytics opt-out, in addition to the existing SHOPIFY_CLI_NO_ANALYTICS=1 environment variable (2cb5f44)

3.94.3

What's Changed

• Fix dev and build command for web_pixel extensions by @vividviolet in #7401
• Fix build command by @vividviolet in #7409
• Skip manifest generation when bundle dir matches local output by @isaacroldan in #7418

3.94.0

App

• Render footer links in app dev as hyperlinks, if supported by the terminal. (#7259)
• Added a separate Dev Console link to the app dev output for non-embedded apps (#7263)
• report file size for extensions on build and dev (#7205)
• Avoid spurious config prompts:
  • Skip TOML selection prompt when using --reset flag
  • Use default shopify.app.toml without prompting when running config link --client-id with no existing TOML files (#7238)

Theme

• Fix ENOTDIR error when a file path is passed to --path flag in theme commands. The flag now validates that the provided path is a directory and shows a helpful error message suggesting the parent directory instead.
  (#7335)
• Add error handler to chokidar file watcher to prevent unhandled exceptions (#7317)

CLI

• Render task progress bars to stderr to reduce output noise in non-TTY environments (#7295)

Full Changelog: 3.93.2...3.94.0

3.93.2

What's Changed

• Fix wrong wasmPath value in "app function info" command
• hydrogen/Bump cli-hydrogen to 11.1.14

3.93.1

Bug Fixes

• Preserve existing granted scopes during shopify store auth re-auth by @dmerand in #7172
• Add JSON output support for shopify store auth and shopify store execute by @dmerand in #7190

3.93.0

New Features

• Allow non-interactive app init by @nickwesselman in #6640
• Allow --development flag to create a new theme by @graygilmore in #6657
• Add app config validate command by @ryancbahan in #6934
• Add JSON flag to theme preview by @dengjeffrey in #7043
• Add Theme previews via JSON by @dengjeffrey in #6890
• Add shopify store auth and store execute by @dmerand in #7122

Bug Fixes

• fix missing json output for theme info command when dev and theme flags are missing by @FKauwe in #6905
• Fix crash when organization is not found by @lizkenyon in #7012
• Fix theme dev shortcut to editor tracking non page requests by @EvilGenius13 in #6924
• Fix infinite 401 retry loop when app logs resubscribe fails by @craigmichaelmartin in #7055
• Ask for an alias on login when the email is not found by @gonzaloriestra in #6935

Performance

• Improve import scanning performance on app dev by @gonzaloriestra in #6930
• optimize asset checksum filtering with Set lookup by @EvilGenius13 in #7105

3.92.1

Theme - Fixed an issue with cart rate limiting

3.92.0

App

• Emit metafile for UI extensions to allow for bundle analysis #6880
• Fix webhooks with relative URIs in app dev #6891
• Detect app dev session takeover #6799
• Add build.typegen_command support for non-JS Shopify Functions #6870

Theme

• Fix theme profile when running on Windows WSL #6830
• More accurate progress on theme pull #6863
• Change hardcoded links in theme pull to use methods to surface urls instead #6881

3.91.1

CLI

• Updates cli-hydrogen to 11.1.10 and removes the --routes flag and confirmation prompt from shopify hydrogen init, now that routes are automatically scaffolded by default. (#6927)

Full Changelog: 3.91.0...3.91.1

3.91.0

What's Changed

• The Dev Console now renders in admin when using shopify app dev.
• The React Router app template now includes declarative custom data features.
• 5e13c83: Add --listing flag to theme dev, push, and share commands
• 947025f: Fix the default environments infrastructure so it doesn’t fail when running commands that don't require authentication
• d0e135b: Fix 401 Unauthorized errors on cart AJAX endpoints during shopify theme dev
• 6a7bfce: Fix hot-reloading for the {% javascript %} tag when serving compiled assets scripts with multibyte characters

Full Changelog: 3.90.1...3.91.0