cli
cli copied to clipboard
Deprecated `sfdx source/mdapi/org` commands will be removed on November 6th, 2024
What's Happening?
On November 6th, 2024, Salesforce will…
- Stop bundling
plugin-source
with the Salesforce CLIsf(v2)
. - Remove the
force:org:create
andforce:org:delete
commands fromplugin-org
.
What's the Impact of This Change?
-
force:source:*
andforce:mdapi:*
commands will not be available for use withsf(v2)
.-
Solution: Migrate to
sf project/org
commands (migration guide) - Workaround 1: Manually install plugin-source after installing the CLI.
- Workaround 2: Use a version of the CLI released before November 6th (<= 2.64.7).
-
Solution: Migrate to
-
force:org:create
andforce:org:delete
will not be available for use withsf(v2)
.-
Solution: Migrate to
sf org
commands (migration guide) - Workaround 1: Manually install an earlier version of plugin-org after installing the CLI (<= 4.8.2).
- Workaround 2: Use a version of the CLI released before November 6th (<= 2.64.7).
-
Solution: Migrate to
Why is Salesforce Making This Change?
- Standardizing the
sf
command syntax and structure is part of our strategic vision forsf(v2)
. - Distributing deprecated code for a prolonged period increases complexity and technical debt for the CLI as a whole.
- A large majority of CLI users have already transitioned to the new commands.
Why is This Change Being Made Now?
We understand this will be a disruptive change for customers who postponed migrating away from the deprecated commands.
While there's never a "good" time for changes like this, we decided to make this change now because:
- The impacted commands have been deprecated for over a year.
- Tools and resources exist to help customers make this transition (see below)
- Workarounds exist for customers requiring additional time to make this change.
As mentioned in the "workaround" notes above, customers who need more than four months to migrate can pin themselves to the latest (stable)
CLI version available on November 5th. Changes specific to Winter ’25 (e.g., support for new metadata types) will be incorporated into this version, giving it a reasonable "shelf life" beyond November 6th.
Additional Resources
- The Salesforce CLI Deprecation Policy
-
Migration Guide for
force:source*
andforce:mdapi:*
Commands -
Migration Guide for
force:org:*
Commands
Questions or Feedback?
Please share any questions or feedback by commenting on this issue.