Skip to main content

Scheduled Rollouts

note

Usually referred to online as feature flags, the Statsig UI and SDKs call them feature gates.

Context​

Feature Gates are powerful in ensuring a safe, controlled feature rollout. Scheduled Rollouts add a time-based scheduling layer to Feature Gates, enabling you to pre-set any rollout schedule you want, which will execute automatically. This is particularly useful if, for example, you have a feature launch happening in another timezone (and don’t want to stay up all night!) or you have a standard, company-wide ramp-up schedule you follow with every feature release.

Scheduled rollouts are set at the Feature Gate rule level, enabling maximal flexibility. Not all rules in your Gate need to include a scheduled rollout, simply set it up for whichever rules make the most sense.

Setting up a Scheduled Rollout​

To set up a Scheduled Rollout on a rule in your Feature Gate, simply tap on the “…” in the upper right-hand corner of the rule you want to schedule a rollout for.

Screen Shot 2022-11-03 at 3 57 52 PM

Select Edit Rule or Rollout, and then select Schedule Automated Rollout.

Screen Shot 2022-11-03 at 4 04 00 PM

From here, you can configure each phase of your Scheduled Rollout. You will see in the upper right-hand corner your current pass percentage- this simply reflects the baseline pass percentage you entered for your rule and can be changed via Edit Rule. To add phases to your rollout, click Add Phase and configure as many phases as you want.

Each scheduled rollout phase includes-

  • Rollout date
  • Rollout time*
  • Pass percentage

*Please note that rollout times are available in 15 minute increments. Additionally, each configured phase represents a discrete increase to the next rollout percentage, not a gradual rollout amortized over the course of the entire phase.

Screen Shot 2022-11-03 at 4 06 51 PM

As you are building your Scheduled Rollout, you will see a preview of the phases below the configuration wizard. This preview is also available for viewers of your Feature Gate on hover over a rule.

Screen Shot 2022-11-03 at 4 08 33 PM

Screen Shot 2022-11-03 at 4 05 29 PM

Executing a Scheduled Rollout​

Once configured, each phase of a Scheduled Rollout will execute automatically on the schedule specified. The Feature Gate creator, any editors, and anyone Following the Feature Gate will receive Scheduled Rollout notifications.

Notifications will be sent via:

  • Email
  • Console
  • (Optional) Slack
    • To configure Slack notifications on Statsig, go to “Account Settings → Notifications”