Remove deprecated --force flag from shopify app deploy#7520
Open
alfonso-noriega wants to merge 1 commit into
Open
Remove deprecated --force flag from shopify app deploy#7520alfonso-noriega wants to merge 1 commit into
shopify app deploy#7520alfonso-noriega wants to merge 1 commit into
Conversation
Contributor
Author
This was referenced May 11, 2026
4 tasks
alfonso-noriega
temporarily deployed
to
breaking-change-approval
GitHub Actions
Inactive
The --force (-f) flag and SHOPIFY_FLAG_FORCE env var on `shopify app deploy` were deprecated in favor of --allow-updates / --allow-deletes. This change removes them along with the related deprecation warning and tests. The internal `force` variable is preserved (now driven by --no-release) so that --no-release continues to imply allowUpdates/allowDeletes and skips the legacy-extension prompt as before — no behavior change for --no-release users. User-facing copy that referenced --force in error/next-step messages has been updated to point at --allow-updates / --allow-deletes.
alfonso-noriega
force-pushed
the
01-remove-app-deploy-force-flag
branch
from
e126ffb to
96281e6
Compare
Contributor
|
| Changeset | Package |
|---|---|
remove-app-deploy-force-flag.md |
'@shopify/app': major |
thin-webs-notice.md |
'@shopify/plugin-did-you-mean': major |
thin-webs-notice.md |
'@shopify/plugin-cloudflare': major |
thin-webs-notice.md |
'@shopify/create-app': major |
thin-webs-notice.md |
'@shopify/cli-kit': major |
thin-webs-notice.md |
'@shopify/store': major |
thin-webs-notice.md |
'@shopify/theme': major |
thin-webs-notice.md |
'@shopify/app': major |
thin-webs-notice.md |
'@shopify/cli': major |
thin-webs-notice.md |
'@shopify/e2e': major |
🏳️ Removed Flags
The following flags were removed from existing commands:
| Command | Flag |
|---|---|
app:deploy |
--force |
alfonso-noriega
temporarily deployed
to
breaking-change-approval
GitHub Actions
Inactive
isaacroldan
approved these changes
May 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
WHY are these changes introduced?
The
--force(-f) flag andSHOPIFY_FLAG_FORCEenvironment variable onshopify app deployhave been deprecated for some time (the command currently renders a deprecation warning when they're used). Users have been pointed to--allow-updatesfor CI/CD environments, or--allow-updates --allow-deleteswhen removals should also be allowed. This PR removes the deprecated flag and its dead-code paths in preparation for the next major release.This is the first PR in a stack that removes the deprecated CLI fields and flags — see #7521, #7522, #7523, #7524, #7525, #7526, #7527.
WHAT is this pull request doing?
--force/-fflag definition and theSHOPIFY_FLAG_FORCEenv binding fromshopify app deploy.packages/app/src/cli/commands/app/deploy.test.ts).prompts/uid-mapping-error.tsandservices/context.tsso the next-step text points at--allow-updates/--allow-deletesinstead of--force.prompts/deploy-release.tsaccordingly.forceparameter passed to the deploy service: it is now derived from--no-releaseonly. This keeps the existing--no-releasesemantics intact (it implicitly allows updates and deletes and skips the legacy-extension prompt), so no behavior change for--no-releaseusers.packages/cli/oclif.manifest.json,packages/cli/README.md, anddocs-shopify.dev/commands/interfaces/app-deploy.interface.ts.How to test your changes?
pnpm shopify app deploy --forceand confirm it now fails with an unknown-flag error.pnpm shopify app deploy --helpand confirm-f, --forceis no longer listed.pnpm shopify app deploy --no-releaseand confirm it still creates a non-released version without prompting.pnpm shopify app deploy --allow-updates --allow-deletesand confirm the previous--forcesemantics still work.Checklist
patchfor bug fixes ·minorfor new features ·majorfor breaking changes) and added a changeset withpnpm changeset add