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.

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 + to add additional variations to string, number, or JSON flags.
7. (Optional) Change the default on and default off variations if needed.
8. (Optional) Click on your member name to change the flag maintainer.
9. (Optional) Click the tag icon to add one or more tags.
10. (Optional) Click the views icon to add the flag to a view.
11. (Optional) Click All SDKs to make the flag unavailable to client-side or mobile SDKs. Flags are available to all SDKs by default.
12. (Optional) Click Temporary to change the flag from temporary to permanent.
13. 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 update flag targeting.

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:

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

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