Manage flags

  • Updated
  • Optimizely Feature Experimentation

Flags are the foundation of Optimizely Feature Experimentation. They give your team full control over how and when features reach your users, without requiring a code deployment. Whether you are gradually rolling out a new capability, running an A/B test, or targeting a specific audience segment, flags let you manage every step of the feature lifecycle.

Flag rulesets and states

A ruleset is the collection of rules associated with a flag. See New flag and rule lifecycle management FAQs for information.

Rulesets can be in one of the following states:

  • Draft – The flag was recently created and has never been enabled.
  • Running – The flag is enabled and running.
  • Paused – The flag was previously turned on and now paused, with any rules not running or delivered to new users.

Each newly created ruleset (which includes the flag's environment and rules) starts in Draft status.

When you create a flag, Feature Experimentation automatically assigns you the Admin role for that flag using  granular permissions, so you can immediately manage the flag and share access with other collaborators. This prevents workflow disruptions where someone creates a flag but cannot update it or assign permissions afterward.

Feature flags, also called feature toggles or permission toggles, let you turn certain functionality on and off without deploying code. They give you full control over the lifecycle of a feature. With feature flags, you can:

  • Release code without exposing it to users by keeping the flag off.
  • Gradually roll out a feature to a portion of your user base.
  • Validate functionality and performance before a full release.

Create a flag

Go to Flags > Create New Flag.

  1. In the Name field, enter a unique name. Valid keys contain alphanumeric characters, hyphens, and underscores, are limited to 64 characters, and cannot contain spaces.

    Feature Experimentation automatically assigns a key to the flag based on this name. You use the flag key to implement the flag in your application's code.

    Flag keys cannot be changed after they are created.

  2. (Optional) Enter a Description.
  3. (Conditional) Enter values for any custom fields your organization added in the Feature Experimentation settings. See Custom fields in Feature Experimentation.
  4. Click Create Flag to save your flag. Feature Experimentation automatically creates
    • A read-only flag_off variation to use as the control in experiments.
    • Two environments, Production and Development.
Custom fields are currently in beta. Contact your Customer Success Manager for information.

Permissions required to create a flag

To create a flag in Feature Experimentation, you must have access to an environment in the project. When you create a flag, Feature Experimentation automatically assigns you the Admin role for that flag. To create a flag or audience, you must have Editor or above access in at least one environment.

If your project does not use granular permissions, the collaborator must have an Editor or above project role.

Get test ideas with Optimizely Opal

Administrators must grant users access to Optimizely Opal.

Opal is enabled by default for eligible customers, but you do not have access until an administrator enables it for each individual using Opti ID. For steps, see Get started with Optimizely Opal for Admins.

You can get potential test ideas with Optimizely Opal. Opal incorporates best practices developed within Optimizely to provide potential experiment ideas.

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.

  1. Click Flags.
  2. Click Get Test Ideas. The Optimizely Opal chat displays with the following message: Please provide a website URL or image and I'll start my analysis!
  3. Enter the URL or upload an image, and then click Submit or press Enter.

  4. Optimizely Opal analyzes a screenshot of the provided URL or image and then provides some test ideas for improvement. Improvements can include clarity of the value proposition, call-to-action, readability, and so on. 

Start flag

  1. Go to Flags and select your flag with a paused ruleset.
  2. Select your environment.
  3. Click Run on the Ruleset. 0f85eb2-image-2.png

Pause flag

  1. Go to Flags and select your flag with a running ruleset.
  2. Select your environment.
  3. Click Pause on the Ruleset. 6e82f8f-image.png

Archive flag

You can archive a flag to remove it from the list of flags. Archiving a flag also removes it from the datafile.

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

  1. Go to Flags.
  2. Click More (...) for the flag.
  3. Click Archive. ccad5c7-image.png

Unarchive flag

  1. Go to Flags.
  2. Click the Archived drop-down list and select Yes.
  3. Click More (...) for the flag you want to unarchive.
  4. Click Unarchive. f02f85e-image.png

Delete flag

  1. Go to Flags.
  2. Click More options (...) for the flag.
  3. Click Delete.

Implement flag

See Implement a feature flag section in the developer documentation for information on implementing the Feature Experimentation decide method to enable or disable a flag for a user in your application code. 

Update custom fields

Custom fields are currently in beta. Contact your Customer Success Manager for information.
  1. Go to Flags and select your flag.
  2. Go to Settings.

  3. Update the custom fields for the flag.

  4. Click Save.

See Custom fields in Feature Experimentation.