No results for ""
EXPAND ALL
  • Home
  • API docs

Deprecating flags

Read time: 4 minutes
Last edited: Aug 16, 2024

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.

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. Navigate to the Flags list.
  2. Hover on the flag you wish to deprecate, and click the three-dot overflow menu that appears.
  3. Click Manage flag settings.
  4. In the "Deprecate flag" section, click Deprecate. The "Deprecate flag" dialog appears.
  5. The dialog shows you how the flag has been evaluated recently. Choose the environments your team or customers depend on to confirm you can deprecate the flag without unintended consequences.
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. Navigate to the Flags list.
  2. Click Filters. In the "Lifecycle" section, click "Deprecated." The deprecated flag list appears.
  3. Hover on the flag you wish to restore, and click the three-dot overflow menu that appears.
  4. Click Manage flag settings.
  5. In the "Restore flag" section, click Restore. The "Restore flag" dialog appears.
  6. The dialog shows you how the flag has been evaluated recently. Choose the environments your team or customers depend on to confirm that restoring the flag will have no unexpected consequences.
  7. Click Restore. The flag appears in the live Flags list.
Restoring a flag means it will be evaluated again

When you restore a flag, it returns to evaluation just like any other flag. This is why it is important to confirm that the flag will have no unexpected impact after you restore it.