1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-22 19:07:54 +01:00
unleash.unleash/website/docs/reference/archived-toggles.md
2024-05-24 13:28:49 +03:00

1.9 KiB

title
Archived Flags

You can archive a feature flag when it is not needed anymore. You do this by clicking the "Archive" button on the feature flag details view. When you archive a feature flag, it will no longer be available to Client SDKs.

The Unleash flag view showing a focused "archive feature flag" button, highlighted by a red arrow.

Viewing archived flags

Archived flags are displayed in two places:

  1. The global flag archive
  2. The containing project's flag archive

Unleash keeps a list of all archived flags across projects in the global archive. The global archive is accessible from the global feature list.

Additionally, each project keeps a list of all of its archived flags. That is, when you archive a flag, Unleash adds it to the containing project's archive.

Reviving a feature flag

If you want to re-use a feature flag that you previously archived, you can revive in from the feature flag archive. Click the "revive icon" to revive the flag. Revived flags will be in the disabled state when you re-enable them.

A list of archived flags. Each flag displays its name and project it belongs to. Each flag also has a "revive" button, as highlighted by a red arrow.

Deleting a feature flag

:::caution

We generally discourage deleting feature flags. The reason is that feature flag names in Unleash are used as identifiers, so if you were to delete a flag and then create a new one with the same name, the new one would reactivate any code that uses the old flag.

:::

The only way to fully delete a feature flag in Unleash is by using the archive. An archived flag can be deleted via the API or by using the "delete feature flag" button in the global or project-level archive.

A list of archived flags, each with a button to delete the flag permanently.