Skip to content

Create a Flag

To create a flag, first navigate to the "Flags" screen in the left navigation bar.

  1. From the Flags screen in Experiment, select your target project from the dropdowns.
  2. Click Create Flag.
  3. Enter a Name for the flag.
  4. Experiment will automatically generate a normalized Key for your flag/experiment. The key is the string which is used to access the variant in you application. You may choose to customize this key, as once the key is set it can't be changed.
  5. (Optional) Enter a Flag Description to better describe the flag.
  6. Save the experiment configuration. You can edit most fields from the flag's settings.

Add a deployment

Once you've created the flag, you'll need to add a deployment. Add one or more deployments using the Settings card on the Configure page.

Screenshot of settings card with deployments

Multiple Deployments

You may select multiple deployments in the dropdown if you want to target multiple deployments. For example, if you are running an experiment on both your iOS and Android apps, you should create separate deployments for each and select both in the multi-deployment experiment.

Define variants

After you have created your flag, you are ready to define its variants. A flag will contain an initial variant, "on", by default. If you are rolling out more than one variant of a feature, add variants using the Create Variant button. Make sure to add descriptions to your variants so that your team members can follow along.

Your flag must have at least one variant.

Screenshot of variants in configure tab

Configure targeting rules

Your flag won't target any users by default. To target users, set the Percentage Rollout to 100%. Now all evaluated users will be assigned the "on" variant for this feature flag.

Screenshot of allocation card with percentage rollout

Activate the flag

Once you're done configuring your flag, activate the flag using the toggle in the upper right corner and follow the instructions in the activation modal.

Screenshot of top navigation bar with active toggle