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

Flag prerequisites

Read time: 4 minutes
Last edited: Oct 03, 2024
Flag prerequisites is an Enterprise feature

Flag prerequisites is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to use feature flag prerequisites to enable or disable features based on different states.

Prerequisites allow you to control feature dependencies in LaunchDarkly. You can make flags depend on other flags being enabled to take effect.

About prerequisite and dependent flags

To meet a prerequisite, the prerequisite flag must be On, and the context must be receiving the variation of the prerequisite flag that you specify. If the prerequisite is met, the dependent flag's targeting rules are evaluated. If the prerequisite is not met, the dependent flag serves the "If targeting is off, serve" variation.

In the following example, the prerequisite is met when the prerequisite flag is On and the target is receiving the "Enabled" variation of the prerequisite flag:

The "Prerequisites" section on a dependent flag.
The "Prerequisites" section on a dependent flag.
Prerequisite flags must be on

To meet a prerequisite, the prerequisite flag must be On. LaunchDarkly considers the prerequisite unmet if the prerequisite flag is Off, no matter what variation of the prerequisite flag the target is receiving.

For example, if a prerequisite flag serves "false" when targeting is Off, even if the variation specified in the prerequisite section is "false," LaunchDarkly still considers the prerequisite unmet when the flag is Off.

Behavior when prerequisites are unmet

If the prerequisite flag is Off, or if the context isn't receiving the specified variation of the prerequisite flag, the context will receive the "If targeting is off, serve" variation of the dependent flag.

Add or update a prerequisite for a flag

You can add a prerequisite when you create the dependent flag, or when you add or update targeting rules for the dependent flag.

Add prerequisites to a new flag

To add a prerequisite when you create the dependent flag:

  1. Follow the instructions for creating a new flag.
  2. In the "Additional configurations" section, under "Prerequisite flags," click + to add a prerequisite flag.
  3. In the Flag field, find and select the prerequisite flag.
  4. In the Variation field, select the variation of the prerequisite flag.
  5. Click Create flag.

If you add a prerequisite during flag creation, the prerequisite applies for all environments.

Add prerequisites to an existing flag

To add a prerequisite flag to an existing flag, in a particular environment:

  1. Navigate to the dependent flag's targeting page.
  2. Click the + Add rule button and select Set prerequisites.
  • If there are existing prerequisites, find the prerequisite rules and select Edit. Then click + to add an additional prerequisite.
  1. In the Flag field, find and select the prerequisite flag.
  2. In the Variation field, select the variation of the prerequisite flag.
  3. Click Review and save.

Update or remove prerequisites

To update or remove a prerequisite flag in a particular environment:

  1. Navigate to the dependent flag's targeting page.
  2. Find the "N prerequisite flags" section. "N" represents the number of prerequisite flags specified for this dependent flag in this environment.
  3. Click Edit:
  • To update an existing prerequisite, update the Flag or Variation fields.
  • To add a new prerequisite, click +. Then update the Flag or Variation fields for the new prerequisite.
  • To remove a prerequisite, click -.
  1. Click Review and save.

Repeat this procedure as necessary for other environments. When you update or remove a prerequisite flag from the dependent flag's targeting page, the change only applies to the current environment.

Multiple prerequisite flags

Flags can be dependent on multiple prerequisite flags. If a dependent flag has multiple prerequisite flags, then all of the prerequisite flag requirements must be met for LaunchDarkly to evaluate the dependent flag for a context.

A prerequisite flag displays any dependent flags on its targeting page:

The dependent flag section of a flag.
The dependent flag section of a flag.

LaunchDarkly automatically prevents you from saving changes that would introduce circular dependencies between prerequisites. For example, you cannot make Flag A a prerequisite of Flag B and also make Flag B a prerequisite of Flag A.

Deleting flags with dependents

You cannot delete a flag that is a prerequisite for other flags. You must remove the dependency before you can delete the prerequisite flag.