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

Edit projects

Read time: 5 minutes
Last edited: Nov 08, 2024

Overview

This topic describes project settings and how to update them.

Edit projects

  1. Click the project dropdown. The project menu appears:
The project menu.
The project menu.
  1. Select Project settings.

The following table describes the various project settings that you can update:

Project settingsChanges you can make
General
  • Update the project's Name.
  • Update the project's tags.
  • Delete the project.
Environments
  • Create, edit, or delete environments in this project. To learn more, read Environments.
Flags
Release pipelines
  • Create, edit, or delete release pipelines in this project. To learn more, read Release pipelines.
Context kinds
  • Create, edit, or delete context kinds in this project. To learn more, read Context kinds.

You can also use the REST API: Update project

Flags settings

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

Client-side availability

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

  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 "Client-side availability" section, check SDKs using Mobile Key or SDKs using Client-side ID.
  4. Click Save.
Security implications of making flags available to mobile SDKs

SDKs for mobile devices use mobile SDK keys, which are readily available to mobile apps. A leaked mobile SDK key allows the holder to circumvent JavaScript's Secure Mode. This can give the holder access to the value of every flag for any context, even without knowing the SDK key that hashes the context key in Secure Mode.

To learn more, read Client-side, server-side, and edge SDKs.

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. 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 key conventions" section, select a Casing convention. Review the example to confirm the convention you've selected:
The Flag key conventions section, with "camelCase" selected.
The Flag key conventions section, with "camelCase" selected.
  1. (Optional) Check Add prefix and enter a Prefix that all flag keys should use.
  2. 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. 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 pencil icon on the flag template you wish to modify and follow the section for that flag template:

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.