Each feature flag has its own setting options. In order to change feature flags settings:
-
Go to the CloudBees Feature Management dashboard and on the left sidebar, select
. -
Select a feature flag.
-
To get to the feature flag settings, select the Settings tab at the top, next to Audience.
All feature flags settings are environment specific. |
Feature flag settings include:
-
Feature flag description
-
Feature flag variations (only for number or string-based flags)
-
Feature flag label
-
Feature flag stickiness property
-
Clone feature flag to an environment
-
Hide or unhide feature flag
When editing the settings, your modifications are saved automatically. |
Feature flag description
General feature flag descriptions can be used by the team for any notes associated with this feature flag and in this environment.
Feature flag variations
For string or number flags, you can add or remove variations from the feature flag setting tab:
-
Go to the feature flag Settings tab.
-
Edit Variations > Edit.
-
Delete Variation by clicking on the garbage icon.
-
Click
+ Add another variation
to add another possible value.
You can only remove variants that are not actively being used in the Audience screen. |
Define variations
When setting targeting for number or string-based flags, you are also able to decide if you want to use predefined variations or some free texts as targeting values. Variations are useful when you have string or numerical values which cannot be completely predetermined. (For example, timeout value, URL address, and more) Set it to off in order to use free text within the targeting screen.
Feature flag labels
Labels help you categorize and mark feature flags. This is helpful for managing different stakeholders, different deployment types, or any external marking of feature flags. For example, you can add a label to feature flag with the name of a specific group that "owns" specific feature flags.
You can also filter by labels using Flag filters on an environment’s overview page.
Working with labels
To add a new label to the system:
-
Go to App Settings > Labels tab.
-
Click Add a new label.
-
Enter a name and a description.
To add a label to a feature flag:
-
Go to the Settings tab of a feature flag.
-
Select the label from the drop-down menu. You can add many labels to a feature flag.
-
On the main feature flags dashboard, click on the label to filter for feature flags with the same label.
Feature Flag Stickiness Property
The Stickiness Property determines the property that is the basis for stickiness behavior for a particular feature flag.
The default value for the Stickiness Property is distinct_id
, which
is a UUID generated by the end device, or a randomly generated number in
the server side SDK. The distinct_id
is stored on the local storage of
the device.
The Stickiness Property is used by the system to determine what value a user should get when Splitting values. For more information, refer to How split by percentage works.
The Stickiness Property is changed when you want to have a consistent behavior across multiple devices.
For example, if you choose userId
as the Stickiness Property, the
userId
has consistent behavior on all of his or her devices. Another
example is using the account_id
as the Stickiness Property. This
creates a consistent behavior for all users in the same account.
To change the default (distinct_id
) Stickiness Property:
-
Go to the CloudBees Feature Management dashboard.
-
Go to the relevant Environment.
-
Click on the feature flag you wish to configure.
-
Click on the Settings tab.
-
Click on Edit in the Stickiness Property box.
-
In the Edit Stickiness window, select the drop-down arrow to choose a Stickiness Property.
-
Select Update Property.
If a user deletes the application, a new distinct_id is generated when
a new application is created.
|
Cloning a flag configuration
Cloning a flag configuration overrides the destination flag configuration. |
Cloning a flag configuration copies a feature flag’s rules, targeting state, and hidden/visible state to override the flag configuration in another environment. Cloning enables you to efficiently set up a flag configuration in a different environment.
You need to have Full access permission to the destination environment to clone a flag configuration.
A flag configuration can only be cloned to the flag of the same name in the destination environment. Cloning a flag configuration does not create a new flag. |
To clone a flag configuration to another environment:
-
From the CloudBees Feature Management Home page, select Flags in environments, and then select an environment.
-
Select the three vertical dots to the right of the flag you want to clone, and then select Clone to environment.
Figure 1. Cloning a flag configuration from the environmentAlternatively, select Settings and review the flag configuration, and then select Clone to environment. Figure 2. Cloning a flag configuration from flag Settings -
Select the destination environment.
-
Select Override flag.
The flag configuration is cloned, and opens on Audience in the destination environment. The destination environment configuration is overridden.
Feature Flag Hide/Unhide
Each feature flag can be either in a visible or hidden mode. Hidden feature flags are flags you cannot or will not remove from the code, but do not want to view them in the main feature flags interface.
-
Hiding a feature flag does not do anything to the feature flag aside from putting it in the hidden feature flags tab.
-
When a feature flag is hidden, you can unhide it from the feature flag Settings tab.