Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

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.