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 in any major update of Salesforce CLI.
  • Salesforce removes the deprecated command or parameter in the next major release of Salesforce CLI. For example, if Salesforce deprecates a command in version 51, it doesn’t appear in version 52.
  • 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.