Prerequisites
To use the Releases page, you need:- Access to the Release Autopilot product offering on your Developer, Foundation, or Enterprise plan.
- Flags that have a release, started from a release plan or a custom configuration.
- Permission to view releases in the project.
Open the Releases page
To open the Releases page, navigate to your project and click Releases under “Feature management” in the navigation. The Releases page is scoped to the project you are in. Use the search box and the quick filters to narrow the list.Read the release list
The list shows one row for each flag release that is pending, in progress, or finished. Finished releases show whether the flag is ready for code removal or archival. Expired, cancelled, and archived releases do not appear on the list. Each row displays the flag’s full release plan from start to finish, with the current environment highlighted. Flags that follow different release plans appear side by side. Only flags that have a release appear in the list. A flag with no release does not appear, even if someone started a guarded rollout on it by hand. Each row includes the following information:| Row element | Description |
|---|---|
| Feature flag | The feature flag associated with the release. |
| Current status | The release environment and the status it is in, such as Pending, In progress, Ready, Needs attention, Paused, Rolled back, or Completed. |
| Release plan | The release plan it follows, shown from the first environment to the last, followed by the cleanup steps. |
| Maintainer | The member or team that maintains the flag. |
| Release started | The date the release started. |
| Pull request | A link to the GitHub pull request that started the release. Releases that were not started from a pull request show no link. |
Filter the list
Use the search box to find a flag by name or key. Use the All releases, Regressions, or Ready for cleanup quick filters to narrow the list. The Regressions filter excludes rolled-back releases. To see only the flags that a member or team maintains, click the maintainer’s name in the relevant row.View release details
To read about the details of a release, click the flag name in the “Feature flag” column. This opens the flag’s release overview, where you can read about the pull request that started the release, the rollout steps for each environment, and the cleanup steps. To preview a release without leaving the Releases page, hover over the status in the “Current status” column, or an environment in the “Release plan” column. The Releases page is read-only. To roll back a release, dismiss a regression alert, or stop monitoring a guarded rollout, open the flag’s Targeting or Monitoring tab. To pause or resume auto-release, go to the flag’s Release tab and click Pause auto-release or Resume auto-release. To learn more, read How auto-release works.Get release data programmatically
The Releases page shows flag releases. You can get the status of a flag’s release in each environment through the Environment releases REST API, which is in public beta. Use it to list and get a flag’s current and past releases in an environment, and to start or stop a release in an environment. The API returns releases that ended within the last 90 days. Requests require theLD-API-Version: beta header. The LaunchDarkly CLI includes matching commands in the environment-releases-beta group: list, get, start, and stop.
Run ldcli environment-releases-beta --help to see them. With the API or the CLI, an agent or integration can check whether a release in an environment finished or is stuck without opening the UI.
A release in an environment is made up of phases, and each phase is made up of rollout steps. Each environment in a release plan has one of the following statuses.
The API values don’t always match the labels shown for environments on the Releases page. The following table shows the label each value appears as for the release environment:
| API status value | Releases environment label | Description |
|---|---|---|
pending | Pending | The release or phase has not started. |
in_progress | In progress | The release or phase is progressing and does not need action. |
waiting | Regression detected or Next phase ready | The rollout is partially complete, paused, and waiting for you to take action. A waiting environment shows as “Needs attention” with the reason “Regression detected,” or as “Needs attention” with the reason “Next phase ready”. |
completed | Completed | The release or phase reached the target variation. |
reverted | Rolled back | The release or phase returned to the original variation. |
waiting, completed, or reverted status can also have one of the following statusReason values:
| Status reason value | Description |
|---|---|
waiting_regression_detected | LaunchDarkly detected a regression in a monitored metric and paused the rollout until you take action. |
waiting_phase_ended | A phase of a multi-phase release that advances manually ended, and you must advance the release to the next phase. This value appears only on the release in an environment, never on a phase. |
completed_automatic | The release or phase reached the target variation automatically. |
completed_manual | A member completed the release or phase manually. |
reverted_regression_detected | LaunchDarkly detected a regression and rolled back the release. |
reverted_manual | A member rolled back the release manually. |
reverted_discarded | The phase ended without a regression or a manual rollback. A running phase is discarded when the flag changes during the phase, for example when someone turns off, archives, or deletes the flag. A pending phase is discarded when the release ends before the phase starts. The release in an environment has this value only when the last phase that started was discarded. |
reverted_insufficient_data | LaunchDarkly rolled back the release or phase because there was not enough data to evaluate it. |