A feature rollout enables you to safely deliver a new feature to your users by controlling who sees it, and when. For more information about what a rollout is, see Introduction to rollouts.
To roll out a feature in Targeted Rollouts projects (default in accounts created after July 2020), ensure you're using the following compatible SDK versions: Swift: 3.3.2 and higher. Agent: 1.1.0 and higher. Go: 1.2.0 and higher. All other SDKs: 2.0.0 and higher.
To roll out a feature:
- (Prerequisite). Create and implement a feature flag for the functionality you intend to roll out. See Create feature flags.
- Under Rules, select an environment from the dropdown.
- Set up rules for your rollout. Rules evaluate in the order in which you drag and drop them, using the OR operator. To set up rules:
- Search and add audiences for the feature. Otherwise, by default your feature rolls out to a random subset of all your users.
- For each audience or audience combination, adjust the traffic allocation.
- For each audience or audience combination, specify different configures for the feature variables.
- Click Save. If you enable a rollout for a non-zero traffic percentage, clicking Save launches the rollout.
- For each environment, you can set different rules. Repeat the previous steps for other environments you want to configure.
Optimizely uses the Is Feature Enabled call you created when you implemented the feature flag to determine if a user qualifies for the rollout or not. For more information, see Create feature flags.
Rollouts are used for launching features, so no impressions are sent and no extra network traffic is generated. To measure the impact of a feature and track metrics on your Results page, create a feature test instead of a rollout.
Feature rollouts and feature tests operate on the same feature flags, but they have important differences. Before using a rollout or a test, be sure to read Interaction between feature tests and rollouts.
The Features dashboard gives you a snapshot of what is happening to a feature at a given point in time:
- Active Experiments: lists all active (running or paused) feature tests for each feature.
- Environment: lists the available production and staging environments.
Once you've removed a feature flag from your code, you can archive it by clicking the Action icon (…) and selecting Archive.
Archive a feature
Updated 13 days ago