Feature flag settings

4 minute read

Each feature flag has its own setting options. In order to change feature flags settings:

  1. Go to the CloudBees Feature Management dashboard and on the left sidebar, select Flags in environments Environment Name.

  2. Select a feature flag.

  3. To get to the feature flag settings, select 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 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:

  1. Go to the feature flag Settings tab.

  2. Edit Variations > Edit.

  3. Delete Variation by clicking on the garbage icon.

  4. 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:

  1. Go to App Settings > Labels tab.

  2. Click Add a new label.

  3. Enter a name and a description.

To add a label to a feature flag:

  1. Go to the Settings tab of a feature flag.

  2. Select the label from the drop-down menu. You can add many labels to a feature flag.

  3. 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:

  1. Go to the CloudBees Feature Management 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, select the drop-down arrow to choose a Stickiness Property.

  7. Select Update Property.

If a user deletes the application, a new distinct_id is generated when a new application is created.

Feature flags

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:

  1. From the CloudBees Feature Management Home page, select Flags in environments, and then select an environment.

  2. Select the three vertical dots to the right of the flag you want to clone, and then select Clone to environment.

    Cloning a flag configuration from the environment
    Figure 1. Cloning a flag configuration from the environment
    Alternatively, select Settings and review the flag configuration, and then select Clone to environment.
    Cloning a flag configuration from flag settings tab
    Figure 2. Cloning a flag configuration from flag Settings
  3. Select the destination environment.

  4. 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.