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

GIVE DOCS FEEDBACK

Flag statuses

Read time: 3 minutes
Last edited: Jan 29, 2024

Overview

This topic explains what the different flag statuses are, and how to view them in the LaunchDarkly user interface (UI).

Using the flag status indicator

The flag status indicator lets you view when a flag is active or inactive. It's important to understand flag statuses so you know which flags are safe to remove from your code.

Every feature flag has a status that reflects the state of a flag in each environment.

For example, if the flag is listed as "Active" in your Production environment, LaunchDarkly is currently evaluating that flag using your Production SDK key.

Here is a screenshot of flag status indicators on the Feature flags list:

The "Feature flags" list with flag status indicators called out.
The "Feature flags" list with flag status indicators called out.

Flag status definitions

The various flag statuses are explained below:

Status typeNameDefinition
flag status indicator new auto NewYou created the flag fewer than seven days ago and it has never been evaluated.
flag status indicator active auto Active

The flag is being evaluated, and either there are either multiple variations configured, you have made changes to its configuration in the past seven days, or the flag is toggled off.

flag status indicator launched auto Launched

The flag is being evaluated, there is only one variation configured, you have made no changes to its configuration in the past seven days, and the flag is toggled on.



Launched flags that are marked as temporary and are over 90 days old are considered "stale." You may be able to remove this flag from your code.

flag status indicator inactive auto Inactive

The flag has not been evaluated for at least seven days.



Inactive flags that are marked as temporary and are over 90 days old are considered "stale." You may be able to remove this flag from your code.

For example, if you have configured a flag to serve only one variation, and make no configuration changes over a seven-day period, its status changes to "launched." If you do make configuration changes to the flag during that period, its status changes to "active."

Engineering insights uses slightly different definitions

If you are part of the engineering insights Early Access Program, be aware that engineering insights uses slightly different definitions on the flag health page.

In engineering insights, a "Launched" flag must be toggled on, all context instances must have been receiving one variation of the flag over the past seven days, and there must have been no changes to its configuration over the past seven days.

In engineering insights, an "Active" flag is one for which either some context instances have been receiving different variations of the flag, or it is toggled off, or there have been changes to its configuration in the past seven days.

To learn more, read Flag health.