No results for ""
EXPAND ALL
  • Home
  • API docs

Progressive rollouts

Read time: 2 minutes
Last edited: Oct 02, 2024

Overview

This topic explains what progressive rollouts are and why you might use them to release new features incrementally.

To learn how to create a progressive rollout, read Creating and managing progressive rollouts.

About progressive rollouts

Progressive rollouts are an option on a flag's targeting rule in a given environment. A progressive rollout serves a given flag variation to a specified percentage of contexts, and gradually increases that percentage over a specified time.

Use progressive rollouts if you want to randomly allocate traffic by context kind, and automatically increase the amount of traffic to a specific flag variation over time. For example, if you are changing the color scheme on your landing page from a "red" variation to a "purple" variation, you might use progressive rollouts to gradually increase the percentage of customers receiving "purple" from 1% up to 100% in a series of steps over 20 hours:

A progressive rollout configuration on a default rule.
A progressive rollout configuration on a default rule.

As the rollout progresses, the flag variation that any particular customer receives changes only once. In the example above, a customer who was originally receiving the "red" variation would eventually receive the "purple" variation. You do not have control over when in the course of the rollout this occurs for a specific customer. After they start receiving the "purple" variation, they will never receive the "red" variation again, unless you explicitly stop the progressive rollout and update your flag rule to serve "red" to everyone.

Progressive rollouts are one of several options that LaunchDarkly provides to help you release features to production safely and gradually. To learn about other options for releasing features, read Releasing features with LaunchDarkly.