For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Get started
    • Overview
    • Onboarding
    • Get started
    • Launch Insights
    • LaunchDarkly architecture
    • LaunchDarkly vocabulary
  • AgentControl
    • AgentControl
    • Manage AgentControl
  • Feature flags
    • Create flags
    • Target with flags
    • Flag templates
    • Manage flags
      • The Flags list
      • Comparing and copying flag settings
      • Viewing flags across environments
      • Deprecating flags
      • Archiving flags
      • Deleting flags
      • Flag prerequisites
      • The off variation
      • The default rule
      • Flag statuses and lifecycle stages
      • Flag lifecycle settings
      • Project-level flag settings
      • Vega for flag cleanup
    • Code references
    • Contexts
    • Segments
  • Releases
    • Releasing features with LaunchDarkly
    • Release policies
    • Percentage rollouts
    • Progressive rollouts
    • Guarded rollouts
    • Feature monitoring
    • Release pipelines
    • Engineering insights
    • Release management tools
    • Applications and app versions
    • Change history
    • Restoring previous flag versions
  • Observability
    • Observability
    • Session replay
    • Error monitoring
    • Logs
    • Traces
    • Observability metrics
    • Product analytics events
    • LLM observability
    • Alerts
    • Dashboards
    • Service map
    • Vega for auto-remediation
    • Observability MCP server
    • Search specification
    • Observability settings
    • Observability integrations
  • Experimentation
    • Experimentation
    • Experiment metric types
    • Experiment configuration
    • Managing experiments
    • Analyzing experiments
    • Multi-armed bandits
    • Holdouts
  • Metrics and events
    • Metrics in LaunchDarkly
    • Creating metrics
    • Metric groups
    • Events
    • Autogenerated metrics
  • Warehouse native
    • Warehouse native metrics
    • Setting up external warehouses
    • Creating experiments using warehouse native metrics
  • Infrastructure
    • Connect apps and services to LaunchDarkly
    • LaunchDarkly in China and Pakistan
    • LaunchDarkly in the European Union (EU)
    • LaunchDarkly in federal environments
    • Public IP list
  • Your account
    • Projects
    • Views
    • Environments
    • Tags
    • Teams
    • Members
    • Roles
    • Account security
    • Feature previews
    • Billing and usage
    • Changelog
Sign inTry it free
LogoLogo
On this page
  • Overview
  • About deprecating flags
  • Deprecate flags
  • View and restore flags
Feature flagsManage flags

Deprecating flags

Was this page helpful?
Previous

Archiving flags

Next
Built with

Overview

This topic explains how to deprecate flags you no longer need.

About deprecating flags

When a flag is still being served to customers, but it is only being served in older or deprecated versions of your application, it may be time to deprecate it. Deprecating a flag hides it from the live Flags list without archiving or deleting it. You can restore a deprecated flag if you need it, or find it to reference or update its configuration later.

Deprecating flags can simplify your Flags list, especially in situations where you have a long tail of customers using older versions of your applications.

You can only deprecate flags that you use with client-side SDKs.

Deprecated flags are still evaluated, just like live flags. If you are completely done with a flag, you should archive it instead. To learn more, read Archiving flags.

Deprecate flags

To deprecate a flag:

  1. In the left navigation, click Code. The CodeControl menu appears.
  2. Click Flags.
  3. Open the flag you wish to deprecate.
  4. Click the three-dot overflow menu in the right sidebar.
  5. Select Deprecate. The “Deprecate flag” dialog appears.
  6. The dialog shows you how the flag has been evaluated recently.
Deprecating a flag affects every environment in your project

All flags exist in every environment for a project, but often only a few environments matter for your organization’s production processes. Deprecating a flag will remove it from the live Flags list for every environment in the project.

  1. Click Deprecate.

The flag is deprecated and removed from the live Flags list. You can find it in the deprecated Flags list. To learn more, read View and restore flags.

View and restore flags

By default, the Flags list shows live flags only.

To view deprecated flags, click Filters from the Flags list and select “Deprecated” under “Lifecycle”:

The Flags list Filters, with the lifecycle options shown.

The Flags list Filters, with the lifecycle options shown.

To restore a deprecated flag:

  1. In the left navigation, click Code. The CodeControl menu appears.
  2. Click Flags.
  3. Click Filters. In the “Lifecycle” section, click “Deprecated.” The deprecated flag list appears.
  4. Click a flag name to open the flag you wish to restore.
  5. Click the three-dot overflow menu in the right sidebar.
  6. Select Restore. The “Restore flag” dialog appears.
  7. The dialog shows you how the flag has been evaluated recently.
  8. Click Restore. The flag appears in the live Flags list.