Newer Version Available

This content describes an older version of this product. View Latest

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.