Shopify CLI 4.0 Release: SemVer, Auto‑Upgrade, and Removal of Deprecated --force Flag
Update to Shopify CLI 4.0 to enable automatic upgrades and replace deprecated --force flag with granular --allow-updates and --allow-deletes flags.
Update your Shopify CLI to 4.0, adjust CI/CD pipelines to use --allow-updates and --allow-deletes instead of --force, and replace any deprecated commands with their new equivalents.
Summary
Shopify announced the release of CLI 4.0 on March 2026, bringing a new semantic versioning scheme, automatic upgrades, and the removal of the deprecated --force flag from app deploy and app release commands. Under the new SemVer model, feature additions bump the minor version, bug fixes bump the patch, and breaking changes trigger a major release, giving developers a clearer view of what to expect. Automatic upgrades are now enabled by default, with the CLI upgrading itself through the package manager it was installed with, except in CI environments, project‑local installs, or when a major version is released. The upgrade can be turned off with shopify config autoupgrade off if needed. The removal of --force was motivated by its lack of granularity; developers must now use --allow-updates for safe updates and --allow-deletes to explicitly permit deletions. Other deprecated commands and flags were also dropped, including shopify webhook trigger (now shopify app webhook trigger), shopify theme serve (now shopify theme dev), shopify app generate schema (now shopify app function schema), shopify app webhook trigger --shared-secret (now --client-secret), and shopify app generate extension --type (now --template). These changes aim to streamline the CLI workflow and reduce accidental destructive actions in automated pipelines. The release notes also provide migration guidance and links to updated documentation for each new command.
Key changes
- Shopify CLI now follows semantic versioning; minor releases add features, patches fix bugs, and major releases signal breaking changes.
- Automatic upgrades are enabled by default, except in CI, project‑local installs, or major releases, and can be disabled with shopify config autoupgrade off.
- The deprecated --force flag on app deploy and app release is removed; use --allow-updates for updates and --allow-deletes for deletions.
- Deprecated commands are removed: shopify webhook trigger → shopify app webhook trigger; shopify theme serve → shopify theme dev; shopify app generate schema → shopify app function schema; shopify app webhook trigger --shared-secret → --client-secret; shopify app generate extension --type → --template.