Feature flags and AI ConfigsFlag templates

Custom flags

Overview

This topic explains how to get started with custom flags.

While LaunchDarkly provides flag creation templates for the common flag templates discussed in this category, we expect that you will need other flags as well. For ideas and examples of other flags and their use cases, read our guide on Creating flags.

Default flag settings only apply to custom flags

When you create a new flag in the LaunchDarkly UI, you can choose to start with a flag template, or create a custom flag. Each flag template has its own custom default settings that you cannot alter. Only custom flags are affected by the default flag settings you configure at the project level.

To learn more about default flag settings, read Projects.

Create custom flags

To create a custom flag:

  1. Click Create and choose Flag. The “Create flag” dialog appears.
  2. Enter a unique, human-readable Name. A suggested key auto-populates from the name you enter, but you can customize it if you wish.
  3. (Optional) Click Edit key to update the flag key. You’ll use this key to reference the flag in your code.
  4. (Optional) Enter a Description of the flag. A brief, human-readable description helps your account members understand what the flag is for.
  5. (Optional) Click No template and select Custom.
  6. (Optional) Click on your member name to change the flag maintainer.
  7. (Optional) Click on the tag icon to add one or more tags.
  8. Click Create flag.

The flag Targeting tab appears.

After you create a flag, you can make further changes to it as needed, such as:

To learn more, read Creating new flags.

Modify the custom flag template

To modify your custom flag template:

  1. Click the project dropdown. The project menu appears:

The project menu.

The project menu.
  1. Select Project settings.
  2. Select Flags. The Flags settings list appears.
  3. In the “Flag templates section, click the pencil icon next to “Custom.”
  4. Choose Yes or No to mark all custom flags as temporary or permanent.
  5. In the “Variations” section, edit the flag variation Names.
  6. In the “Default variations” section, choose which default variations to serve when the flag is toggled On or Off.
  7. In the “Tags” section, type to add tags to each new flag by default.
  8. Click Save.

Verify that the updated default template settings are correct by navigating to the Flags list and creating a new custom flag.