Affected: All SDKs
Overview
LaunchDarkly uses a bucketing system to consistently assign users to flag variations in a deterministic way. This ensures that users receive the same variation across sessions unless the flag configuration changes. A flag salt is part of the hashing function that determines this bucket assignment.
In some cases, such as testing a new rollout strategy or re-randomizing user assignments, you may want to reset or change the flag salt. Doing so will alter the distribution, meaning users may be reassigned to different variations.
However, this is not available to all customers. It is based on a per-request basis, as LaunchDarkly needs to enable the feature for it to be presented as an option in the UI.
Important: Changing the flag salt can impact user experiences and experiment data. Use caution and ensure stakeholders are informed before making changes.
Solution
To access and update the bucketing salt in LaunchDarkly's UI, follow these steps:
-
Navigate to the Feature Flag:
-
Go to the Feature Flags section and select the flag you want to modify.
-
-
Access Environment Configuration:
- Hover over the box for the environment you'd like to change.
- Click on the three dots (•••) on the right-hand side of the environment box.
- Select Configuration in environment under Flag actions from the dropdown menu.
-
Update the Salt:
- On the Environment configuration screen, look for the Flag bucketing salt field.
- Click Generate random salt or type in a new value manually.
- Once you’re ready, click Save bucketing salt.
Once updated, LaunchDarkly will use the new salt value in its bucketing algorithm, potentially changing which contexts receive which flag variations.