Newer Version Available
CLI Deprecation Policy
Salesforce deprecates CLI commands and parameters when, for example, the underlying API
changes.
The Salesforce CLI deprecation policy is:
- Salesforce can deprecate a command or parameter at any time.
- When you run the deprecated command, Salesforce provides a deprecation warning for a minimum of 4 months.
- Salesforce removes the deprecated command or parameter 4 months, or more, after the deprecation warning first appears.
- If you use a command or parameter that’s been deprecated but not yet removed, you get a warning message in stderr when you specify human-readable output. If you specify JSON output, the warning is presented as a property. The message includes the plug-in version of when the command or parameter will be removed. The command help also includes deprecation information when appropriate.
- When possible, Salesforce provides a functional alternative to the deprecated command or parameter.
- Salesforce announces new and upcoming deprecated commands and parameters in the release notes.