HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Manage flags

Information on how to manage flags in Optimizely Feature Experimentation.

The Flags dashboard gives you a snapshot of what is happening to a flag at a given point in time. You can view rules by environment and add, edit, rearrange, enable, disable, delete, or archive rules.



Multiple experiments per Flag is currently in Beta. Contact your Customer Success Manager for more information.


Turn a flag on or off

Toggling a flag on or off enables or disables all rules for the environment:

Toggle a flag on or off

Toggle a flag on or off

Archive flag

You can archive a flag to remove it from the list of Flags. Optimizely Feature Experimentation keeps your flag and rule data, so you can unarchive the flag later if you wish.

To archive a flag,

  1. Navigate to Flags.
  2. Click the Actions icon (...) for the flag.
  3. Choose Archive from the dropdown menu.

Unarchive flag

To unarchive a flag:

  1. Navigate to Flags.
  2. Click the filter menu and choose Yes from the Archived dropdown.
  3. Click the Actions icon (...) for the experiment.
  4. Choose Unarchive from the dropdown menu.


Reorder, Copy, or Delete rules

In the rules list, click an Actions icon (...) to reorder rules, create a copy of the rule in the current environment, or delete the rule. Select the 6 dots to drag and drop the rules to rearrange them.

To duplicate a rule across an environment, select Add Rule and select Copy rules from and select which environment you want to copy the rules from.

Pause a rule

If you want to enable or disable individual rules within an environment, you can play or pause them:

Pause or play a rule

Pause or play a rule

Manage flag rules

You can add, remove, or update your flag's rules at any time. But, it is advised to turn your flag off before making changes.



Be careful when you are changing experiment parameters, especially the experiment key and variation keys for a running experiment.

DO NOT change the experiment key or variation keys unless you are making the corresponding changes in your code. If you use a key that is not referenced in your code, no traffic will be sent to that experiment or variation.

To edit a flag rule:

  1. Click the rule name to open it.
  2. Change your rule parameters as desired.
  3. Click Save.

Changing your rules will update your project’s datafile within a few seconds. It may take some time before your experiments are updated in production, depending on how often you retrieve datafile updates.

If you want your rules to update in real-time, use webhooks to receive datafile updates.


Changing traffic allocation or group assignment for a running experiment will impact user bucketing, causing users to be bucketed in or unbucketed from this experiment. For more information, refer to How bucketing works.