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

GIVE DOCS FEEDBACK

The flags list

Read time: 7 minutes
Last edited: Jun 05, 2024

Overview

This topic explains how to use the Feature flags list, which shows your feature flags and gives you options to create, modify, and manage them.

All of your feature flags within a project appear on the flags list. Creating a new flag adds it to the list and all environments within your project, and archiving a feature flag removes it from the list and all environments within your project.

Here is an image of the feature flags list:

The flags list.
The flags list.

The flags list shows the following information about each flag for each environment:

  • How many times the flag has been evaluated.
  • Whether the flag is On or Off.
  • Whether the flag is included in a release pipeline, indicated by a "shipped" icon. To learn more, read Release pipelines.
  • Whether the flag is included in a guarded rollout, indicated by a "shield" icon. To learn more, read Release Guardian.
  • A bar showing the proportion of contexts that have been served each variation. For boolean flags, the true ("available" or "enabled") variation is blue and the false ("unavailable" or "disabled") variation is yellow.

Hover over the information for a flag to view more details about its variations, evaluations, and any guarded rollouts or release pipelines the flag is included in.

Features in the flags list vary by plan

To learn more, read about our pricing. To upgrade your plan, contact Sales.

To learn how to create a new flag, read Create a feature flag. To learn how to archive a flag, read Archive flags.

View feature flags

Use the search bar to find a flag by name, key, or description. By default, the most recently created flags appear first.

You can view your flags as a list, or in the project's release pipeline. To view flags in the project's release pipeline, click Releases in the left sidenav. To learn more, read Release pipelines.

Sort feature flags

You can sort the list of visible flags by creation date, by name, or by last modified date. To sort the flags list, click Sort and choose a sorting option:

The "Sort" option on the feature flags list.
The "Sort" option on the feature flags list.

Filter feature flags

You can filter the list of flags to view only flags that share a particular attribute, such as a tag, a status, or availability to an SDK type.

To filter your flags:

  1. Click Filters.
  2. Choose an attribute for a filtering option. The flags list automatically updates.
  3. (Optional) Click Filters again and choose an additional attribute. Repeat as many times as needed.
Two filters applied to the flags list.
Two filters applied to the flags list.

Your flags list now displays only the flags that match the filters you specified.

Filtering by maintainer includes teams

If you filter flags by maintainer, you can choose to view flags maintained by an individual member or by a team.

Remove filters

To clear your filters, click Filters, then click Clear.

Save shortcuts to filtered flags lists

You can create shortcuts to filtered flags lists, and save them in the left sidenav to return to at any time.

To create a shortcut to a filtered flags list:

  1. Navigate to the flags list.
  2. Add your desired environments to the flags list following the instructions in Open environments.
  3. Add any flag filters you need such as tags, maintainers, or flag statuses, following the instructions in Filter feature flags.
  4. Click the bolt icon above the flags list to create a shortcut:
The flags list with the "bolt" shortcut icon called out.
The flags list with the "bolt" shortcut icon called out.
  1. Add a Name for your shortcut.
  2. (Optional) Choose an Icon to represent your shortcut in the left sidenav.
  3. Click Save.

Your shortcut appears in the left sidenav.

A list of shortcuts in the left sidenav.
A list of shortcuts in the left sidenav.

Follow flags

You can follow a flag to receive an email notification, and, if applicable, a notification in the LaunchDarkly Slack app, when someone makes a targeting change to that flag. Notifications are environment-specific, so you must follow a flag in each environment you want notifications for.

If you have the LaunchDarkly Slack app installed, you will automatically receive notifications in Slack about any changes to flags you have followed. To learn more about the Slack app, read Slack.

To follow a flag:

  1. From the flags list, click on the name of the flag you want to follow. The flag targeting page opens.

  2. Click on the name of the environment you want to follow the flag in.

    • If the environment you want is not displayed, click the + to display the list of environments, and select the environment you want.
    The environment selection menu.
    The environment selection menu.
  3. Click on the Follow flag icon.

The "follow flag" icon called out on the flag targeting page.
The "follow flag" icon called out on the flag targeting page.

Save shortcuts to flag targeting pages

You can create shortcuts to a specific environment on a flag's targeting page. This allows you to return to that flag's environment-specific targeting page from a shortcut in the left sidenav.

To create a shortcut to a flag targeting page:

  1. From the flags list, open a flag's targeting page.
  2. Open your desired environment following the instructions in Open environments.
  3. Click the bolt icon in the right sidebar to create a shortcut.
  4. Add a Name for your shortcut.
  5. (Optional) Choose an Icon to represent your shortcut in the left sidenav.
  6. Click Save.

Your shortcut appears in the left sidenav.