Feature Flag Settings

Each Feature Flag has it’s own setting options. In order to change feature flags settings:

  • Go to the CloudBees Feature Flags dashboard and on the left sidebar, click on Flags in EnvironmentsEnvironment 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.

Feature flags

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 variation to add another possible value.

You can only remove variants that are not actively being used in the Audience screen.

Define Variations

On String based flags, you are also able to decide if you want to see the variations as free text for you to change or as predefined variations. Variations are useful when you have string or numerical values which cannot be completely predetermined. (For example, timeout value, URL address, and more)

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 SettingsLabels 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:

  1. Go to the CloudBees Feature Flags dashboard.

  2. Go to the relevant Environment.

  3. Click on the feature flag you wish to configure.

  4. Click on the Settings tab.

  5. Click on Edit in the Stickiness Property box.

  6. 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 flags

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.