---
schema_version: "1"
id: 0582716da8039463aeaf98c9413301c8d77b59951442dd2f10b11b98696a6a64
title: CLI Deprecation Policy
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/guides/sfdx-dev/workspace-setup/sfdx-dev-cli-deprecation.md
canonical_url: https://developer.salesforce.com/docs/analytics/bi-dev-guide-cli-reference/guide/sfdx-dev-cli-deprecation.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9224c57fe4ea0c263170febf02952a2eb2699c4379743cc30bebfc618c3d8042
products:
  - Salesforce Analytics Plugin CLI Command Reference
  - analytics
---

# 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).