Transitions

Transitions can be used to manage flag overrides for many identities at once, or even multiple flags at once. They can also be used to manage default flag values for the environment.

In other words, they are used to transition flag states for multiple identities/flags at once.

Transitions are great for controlled rollouts/rollbacks with an overview of what team member created it, scheduled, applied or reverted.

Transition Status

Transitions go through multiple statuses during their lifecycle:

1. Draft - Once created, the transition will be in this state. This state indicates that the transition is not finalized and is in editing phase.
2. Scheduled - If you decide to schedule a transition instead of applying immediately, it will enter this state. It indicates that the transition is ready to be applied on the specified date and time. If a transition is in this state, it cannot be edited. However, unscheduling the transition will move it back to “Draft”.
3. Applied - Once the transition is executed, either by applying it immediately or by scheduling, the transition will enter this state. From this point it is not possible to delete the transition anymore. It is only possible to edit its basic details like title and description, or revert it.
4. Reverted - When you revert a transition that has been applied, it will enter this state. This is the final state from which no other state can follow.

Managing Transitions

Transitions can be managed from the Transitions page. It is possible to create, compose, edit its basic details, schedule, apply or revert a transition.

Creating Transition

To create a transition, navigate to the Transitions page and click on the “New transition” button at the top. This will create a new untitled transition in “Draft” state, ready to be composed.

Composing Transition

Transition composer will guide you through multiple steps to help you build and define the transition.

Step 1 - Define Actions

When on the “Define Actions” step page, use the search bar to find flags you want to apply the transition for. Once flags are picked, for each flag you can define the following:

• Action on default flag value, which can be either disable or enable. You can also choose not to do any action on the default value.
• Action on flag overrides, where you can choose one of the following options:
  • Do nothing - Flag overrides will not be touched and will remain as they are.
  • Create disabled/enabled flag overrides - Flag overrides will be created for the selected identities (on identities selection step).
  • Drop overrides - Flag overrides will be removed for the selected identities (on identities selection step).

Step 2 - Add Identities

On the “Add Identities” step page, you can use search and filters to find and select identities you would like to apply this transition to. Use the multi-select (checkboxes) to select identities, and then click on “Add identities” in the small pop-up near the bottom of the screen. At the top you can see how many identities have been added so far. You can continue the process of selecting and adding until you’ve added all the identities you want in that transition.

Note

This step will be skipped if you’ve set “Do nothing” for action on flag overrides for all flags defined in step 1.

Step 3 - Review

On this page, on the right side you will see the defined actions described in words that will happen once you apply the transition.

Under that section, you can see all the identities you have selected on step 2. You can remove any identity directly in that list if you decide that some of those should not be included in the transition.

On the left (main) side of the page, you will be presented with two options:

1. Apply transition immediately
2. Schedule it to be applied on a specific date and time

Applying Transition

On the step 3 of the transition composer, choose one of the presented options described previously to apply the transition.

If you chose to schedule the transition, the transition will become closed for further editing and you will see a message displaying the date and time it will be applied on. Once in this state, you will see “Unschedule” button that you can click if you decide to remove the scheduled date and bring transition back to “Draft” state.

Once applied, transition will move to “Applied” state and flags configuration and overrides will be changed in the environment based on the defined actions for that transition.

Reverting Transition

To revert the changes that a transition applied:

1. Navigate to Transitions page
2. Click on “Completed” tab
3. Click on the transition you want to revert
4. Once the report page is opened, click on “Revert transition” button at the top

This will apply the “Previous state” you see in the report table to all the identities, and it will also revert the environment flag default values if there were any in the transition.