Project-level flag settings

Overview

This topic describes project-level flag settings and how to update them.

When you set or update the Flag settings for a project, the changes apply to any new flags created in the project after the settings update. No existing flags are updated.

To access the project-level flag settings:

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

2. Select Project settings.
3. Select Flag settings. The Flag settings list appears.

The following sections describe the available project-level flag settings.

Client-side availability

To make all of a project’s flags available to client-side or mobile SDKs by default:

1. Open the Flag settings screen for your project.
2. In the “Client-side availability” section, check SDKs using Mobile Key or SDKs using Client-side ID.
3. Click Save.

To learn more, read Choosing an SDK type.

Flag key conventions

If you would like to standardize how members of your organization define feature flag keys, you can specify a convention in the project settings and LaunchDarkly will enforce your convention for all new flags. This includes flags that you create or import through the LaunchDarkly user interface, as well as flags that you create using the REST API.

To enforce naming conventions for flag keys:

1. Open the Flag settings list for your project.
2. In the “Flag key conventions” section, select a Casing convention. Review the example to confirm the convention you’ve selected:

3. (Optional) Check Add prefix and enter a Prefix that all flag keys should use.
4. Select Save.

Flag templates

LaunchDarkly projects have groups of default settings, called “templates,” for each type of flag. When you create a flag from a template, that template’s default settings appear as pre-set configuration options.

You can modify default flag templates. LaunchDarkly applies those default settings to new flags of the same template type within the project. Updated default settings only apply to flags created after you modified the default settings. If you change a flag template’s default settings, LaunchDarkly does not retroactively apply the new defaults to existing flags.

To modify a flag template:

1. Open the Flag settings list for your project.
2. In the “Flag templates” section, click pencil icon on the flag template you wish to modify and follow the section for that flag template:

• Custom flag template settings
• Release flag template settings
• Kill switch flag template settings
• Experiment flag template settings
• Migration flag template settings

Custom flag template settings

This section lets you customize the default template settings for custom flags. Here’s how:

1. In the “Flag templates” section, click Edit.
2. Choose Yes or No to mark all flags of this template type as temporary or permanent.
3. In the “Variations” section, edit the flag variation Names.
4. In the “Default variations” section, choose which default variations to serve when the flag is toggled On or Off.
5. In the “Tags” section, type to add tags to each new flag by default.
6. Click Save.

Verify that the updated default template settings are correct by navigating to the flags list and creating a new flag of this template type.

Release flag template settings

This section lets you customize the default template settings for release flags. Here’s how:

1. In the “Flag templates” section, click Edit.
2. Choose Yes or No to mark all flags of this template type as temporary or permanent. Release flags are usually temporary.
3. In the “Variations” section, edit the flag variation Names.
4. In the “Default variations” section, choose which default variations to serve when the flag is toggled On or Off.
5. In the “Tags” section, type to add tags to each new flag by default.
6. Click Save.

Verify that the updated default template settings are correct by navigating to the Feature flags list and creating a new flag of this template type.

Kill switch flag template settings

This section lets you customize the default template settings for kill switch flags. Here’s how:

1. In the “Flag templates” section, click Edit.
2. Choose Yes or No to mark all flags of this template type as temporary or permanent. Kill switch flags are usually permanent.
3. In the “Variations” section, edit the flag variation Names.
4. In the “Default variations” section, choose which default variations to serve when the flag is toggled On or Off.
5. In the “Tags” section, type to add tags to each new flag by default.
6. Click Save.

Verify that the updated default template settings are correct by navigating to the Feature flags list and creating a new flag of this template type.

Experiment flag template settings

This section lets you customize the default template settings for experiment flags. Here’s how:

1. In the “Flag templates” section, click Edit.
2. In the “Tags” section, type to add tags to each new flag by default.
3. Click Save.

Verify that the updated default template settings are correct by navigating to the Feature flags list and creating a new flag of this template type.

Migration flag template settings

This section lets you customize the default template settings for migration flags. Here’s how:

1. In the “Flag templates” section, click Edit.
2. In the “Tags” section, type to add tags to each new flag by default.
3. Click Save.

Verify that the updated default template settings are correct by navigating to the flags list and creating a new flag of this template type.

Require flags to be linked to a view

If you use views to organize flags and restrict access, you can require that new flags are linked to a view. Configure this setting in Project settings under Views, Settings.

To learn how to require flags or segments to be linked to a view, read Require resources to be linked to a view.