Feature Flag Settings
Each Feature Flag has it’s own setting options. In order to change feature flags settings:
-
Go to the CloudBees Feature Management dashboard and on the left sidebar, click on Flags in Environments → Environment Name. This will bring you to the Feature Flag page for the specified environment.
-
Select a Feature Flag.
-
To get to the feature flag settings, click 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 string based flags)
-
Feature flag label
-
Feature flag stickiness property
-
Clone Feature flag to an environment
-
Hide/Unhide Feature flag
|
When editing the settings, you do not need to take any kind of explicit action to save; 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 flags, you can add or remove variations from the feature flag setting tab:
-
Go to feature flag Settings tab.
-
Edit Variations > Edit.
-
Delete Variation by clicking on the garbage icon.
-
Click
+ Add another variationto 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 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 Label
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.
Working with labels
To add a new label to the system:
-
go to App Settings → Labels tab.
-
Click on the Add a new label button and give the label a name and a description.
-
To add a label to a feature flag, go to the Settings tab of a feature flag and 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 Split percentage.
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:
-
Click the drop down arrow to select a Stickiness Property.
-
Click the Update Property button.
-
If a user deletes the application, a new distinct_id is generated when
a new application is created.
|
Feature Flag Clone
You can use this capability to clone an exisiting feature flag configuration accross environments. If a feature flag configuration already exists on the destination environment, the system will prompt you and ask if you want to override the exisiting configuration.
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.