Skip to content
FlagSwiftDocs

Releases

Follow scheduled changes, staged rollouts and changes waiting for approval.

What this page is for#

A release is a planned change to a flag: one change now or later, or a rollout that widens in stages. This page lists them across the organization so reviewers can approve or reject requests and everyone can see what is about to happen. New releases are proposed from a flag's Releases tab.

In the console it lives at /releases. You see it in the sidebar when your role has releases.read.

What you can do#

  • Find a project or a key

    On the overview, search projects by name. Inside a project, search keys and filter by status and environment; the filters apply to every section.

  • Narrow it down

    Filter by who proposed it, project, flag and the date it was created.

  • Approve a release

    Reviewers can approve with an optional note that is shown on the release and recorded in the audit log.

  • Reject a release

    A reason is required, and the proposer sees it.

  • Cancel your own release

    Only the person who proposed an open release can withdraw it. A dialog asks you to confirm, with Keep release to back out. Steps that already ran stay applied.

  • Read the stages

    Each card shows the planned steps with their status and time, plus the reviewer's note.

Good to know#

  • Approve and reject need releases.review. The console does not offer Approve on a release you proposed yourself.
  • Proposing a release needs releases.create. People who cannot review send their proposal for approval.
  • When proposing you choose One change, now or later, or Progressive rollout, give a reason, and optionally name a reviewer.
  • The home Overview shows counts for releases awaiting approval and scheduled releases.
  • The Releases link in the sidebar shows how many are waiting for approval, or a dot when the sidebar is collapsed. The list refreshes itself every 30 seconds without showing a loading state.