---
schema_version: "1"
id: 7ca7094e537d01ef7f67c58e85ec61f58e79af65f0e5dd720b6d3ab3cec00c7c
title: CLI Deprecation Policy
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/cli_reference_deprecation.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_deprecation.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 912ad2abf04a9dddcb2ac04b8f4c7c95872ef413b6707f10792585a6ad3e17db
products:
  - Salesforce CLI Command Reference
  - salesforcedx
---
# 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](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_json_support.htm).