Feature flags enable development teams to progressively toggle features on and off for specific user segments. Flags are defined as Boolean, number, or string types. You can create flags in either the UI or in your application code.
Flag settings
Flag names are case-sensitive and must exactly match in both your source code and the platform UI. Each flag requires a type and a unique name. These values cannot be changed after creation. Flags are scoped to the application in which they are created and are not shared across applications.
Flag setting | Definition | Required? | Editable? |
---|---|---|---|
Name |
The flag name. |
|
|
Description |
Any descriptive information about the flag. |
|
|
Type |
The flag type: Boolean, string, or number. |
|
|
Variation (string or number flags only) |
One or more possible predefined flag values. Each value must be the appropriate type. For example, the string value |
|
|
Label |
A way of organizing flags. For example, tag all flags administered by a specific developer team with the same label. |
|
|
Mark as permanent |
Set a flag, for example, a timeout or URL flag, to permanent status to ignore its impression data. |
|
|
Access the flag overview
Flags are managed at the application level. Each application is linked to one or more environments.
To view a list of flags for an application:
-
Select Feature management.
-
By default the Flags overview page displays.
-
The Flags overview page lists all flags for the selected Application.
Figure 1. Default display for the Flags overview page.
Display options
Flags are available in the environments linked to the selected application. For more information, refer to How flags relate to environments.
The following image shows the Flags overview page and highlights the available display and configuration options.

Descriptions for each numbered option are listed below:
-
Select and manage application-level feature flag resources:
-
Select Application to choose which application’s flags, target groups, and properties to display.
-
Use
to set up the SDK if not already configured.
-
Navigate between the Flags, Target groups, and Custom properties tabs to manage feature configurations and metadata for the selected application.
-
-
Access configuration tools and filter options:
-
Use the Connect your configuration as code (CasC) link to integrate with GitHub and manage flags declaratively.
-
Select
to copy the environment-specific SDK key for use in your application code.
Your SDK key identifies a specific environment within an application and is required to evaluate flags at runtime. Refer to unique environment identifier for more information. -
Use Filters to narrow results by environment, label, status, and other attributes.
-
Search for flags by name, view cleanup candidates, or select Create flag to add a new one.
The number of available cleanup candidates is displayed per total number of flags.
-
-
Review and manage individual flags:
-
View all flags in the selected environment, including their configuration status, labels, impressions, and activity status.
-
Use
to edit, configure, delete, or view audit history for individual flags.
-
Filter flag lists
Filter flags in an environment according to the following criteria:
Filter | Possible options | Reference |
---|---|---|
Configuration status |
|
|
Flag type |
|
|
Label |
Any existing label |
|
Namespace |
Any existing namespace |
|
Activity status |
|
To filter flags:
-
Select Filter. The available filters are displayed.
-
You may apply one or more filters by selecting an option. Refer to the table above for filter descriptions.
-
Filter by environment when the application is linked to multiple environments.
-
Search by flag name.
The results include a list of flags that match your filtering criterion.
Create a flag in the UI
Once a flag is created it is available across all environments that are linked to the application.
Once you create a flag, you cannot edit its name or its data type. |
To create a flag:
-
Select Feature management.
-
Select Create flag.
-
Enter a flag Name.
-
Enter a Description.
-
Select a Type from the options.
-
Enter a value of the appropriate data type for your flag.
-
For string and number type flags, define variations, as follows:
-
Select Define variations.
-
If Define variations is selected, then Add variation is enabled.
-
The Add variation option allows the flag to toggle between multiple values, not just true or false.
-
-
Select Add variation to enter another value.
You may enter unlimited variations.
Figure 3. Creating a flag, with variations highlighted.
-
-
Enter Labels.
-
Select Permanent flag if appropriate.
-
The Permanent flags option ignores impression data and are excluded from cleanup filters. This is useful for flags that serve a static purpose, such as enabling logs or setting timeouts.
-
Examples for use could be, timeout flags, URLs or logging levels. It could also be flags that are always intended to be on or off in production, not part of an A/B test or gradual rollout.
-
-
Select Save.
Once created, the flag is listed in the Flags overview page.
-
Enable the flag configuration by turning the configuration status to On.
Create a flag in code
Create a flag in your source code and run your application. Your newly created flag is displayed in the platform feature management flag list. Refer to Create flags in code to learn more.
Update flag settings
Add to, remove, or edit any flag setting.
To update flag settings:
-
Select Feature management.
-
Select
next to the flag you want to edit.
-
Select Edit.
-
Update the Description, variations, or Labels.
-
Select the next to a variation to remove it, or delete all variations at once by selecting Define variations.
-
Remove a label from a flag by selecting the "X" next to the label name.
-
-
Select Update.
The flag setting(s) are updated accordingly.
Delete a flag
To delete a feature flag, you must first turn off its configuration in all environments. A deleted flag is completely removed from the CloudBees platform, including all environments, and deletion is irreversible.
The flag activity status informs users of the flag lifecycle across all environments, helping them make an informed deletion choice.
Select Show cleanup candidates in the Flags dashboard to display all flags with stale or inactive status. These flags are often a good choice for deletion.
To delete a flag:
-
Select Feature management.
-
Select
next to the flag you want to delete.
-
Select Delete.
-
Select the toggle next to the flag to disable the flag configuration for all environments.
-
Select Delete.
The selected flag is deleted and removed from the flag list.
Filter stale and inactive flags
You can filter stale and inactive flags, known as cleanup candidates, within any environment. Cleaning up these flags by deletion often reduces tech debt. The number of candidates per total flags is listed next to the filter.
To filter cleanup candidates:
-
Select Feature management from the left pane.
-
Select Show cleanup candidates.
The list of flags is filtered to display only those with Stale or Inactive activity status.