CLI Deprecation Policy

Salesforce deprecates CLI commands and flags when, for example, the underlying API changes.

The Salesforce CLI deprecation policy is:

• Salesforce announces new and upcoming deprecations of commands and flags in the weekly Salesforce CLI release notes.
• Salesforce can deprecate a command or flag 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 flag 4 months, or more, after the deprecation warning first appears.
• If you use a command or flag that’s been deprecated but not yet removed, you get a warning message in stderr in the human-readable output. If you specify JSON output, the warning is presented as a property. The message includes the plugin version in which we plan to remove the command or flag. The command help also includes deprecation information when appropriate.
• When possible, Salesforce provides a functional alternative to the deprecated command or flag.

For our policy on changes to a Salesforce CLI command’s JSON response, see Support for JSON Responses.