Salesforce CLI Setup Guide

Quick Start
System Requirements
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
Release Notes
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 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.