Salesforce CLI Setup Guide

Release Notes
Before You Begin
Move from sfdx (v7) to sf (v2)
Install Salesforce CLI
Update Salesforce CLI
Salesforce CLI Configuration and Tips
Uninstall Salesforce CLI or Plugins
Run Salesforce CLI Using a Docker Image
Salesforce CLI Plugins
Troubleshoot Salesforce CLI
CLI Deprecation Policy
Next Steps
PDF

Newer Version Available

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

CLI Deprecation Policy

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

The Salesforce CLI deprecation policy is:

  • 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 when you specify human-readable output. If you specify JSON output, the warning is presented as a property. The message includes the plugin version of when the command or flag will be removed. The command help also includes deprecation information when appropriate.
  • When possible, Salesforce provides a functional alternative to the deprecated command or flag.
  • Salesforce announces new and upcoming deprecated commands and flags in the release notes.