Dev guideAPI Reference
Dev guideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In

Manage flags and rules

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. Archiving a flag also removes it from the datafile. See Manage flags section for more information.

Optimizely Feature Experimentation keeps your flag and rule data, so you can unarchive the flag later.

To archive a flag,

  1. Navigate to Flags.
  2. Click the Actions icon (...) for the flag.
  3. Choose Archive from the drop-down list.

Unarchive flag

To unarchive a flag:

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


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 experiment rules, you must have multiple experiments per flags enabled. Contact your Customer Success Manager if you are interested in being added to the beta.

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.