Skip to content
FlagSwiftDocs

Flag detail

Everything about one flag: its values, targeting, history, releases, analytics and lifecycle.

What this page is for#

The flag detail page is where you manage a single flag. It opens from a project's flag list and is split into tabs, each with a one line description at the top. The Variants tab only appears for flags that have variants, and the Advanced tab only for people who can move flags.

In the console it lives at /feature-flags/[flagId]. Everyone signed in can open it.

What you can do#

  • Overview tab

    Edit the display name and description, and switch the flag on or off in each environment.

  • Variants tab

    Edit the values the flag can serve. Saved keys cannot be renamed, and a variant an environment still serves cannot be removed.

  • Targeting and rollout tab

    Pick an environment, then set people, accounts and devices that always get the flag, segments, attribute rules, prerequisite flags, a rollout percentage, and variant weights.

  • Check who gets the flag

    In the targeting tab, enter a user, account or device to see whether it is served, which variant, and why.

  • History and rollback tab

    See every saved version, roll an environment back to an earlier one with an optional reason, and export the activity as CSV or JSON.

  • Releases, Analytics and Lifecycle tabs

    Propose a scheduled or staged release, read evaluations per environment, and set the owner, removal dates and permanent status, with any code references.

  • Advanced tab

    Move the flag to another project, archive it, or restore and delete an archived flag. Each of these opens a confirmation dialog.

Good to know#

  • Without flags.update the tabs are read-only, except history, analytics and releases.
  • An archived flag is read-only apart from history and the Advanced tab, where it can be restored or deleted. Deleting needs you to type the flag key.
  • The Advanced tab needs flags.move. Archive needs flags.archive, restore needs flags.update and delete needs flags.delete.
  • Prerequisites only hold back the rollout. People who are targeted, in a segment or matching a rule are not held back.
  • The Analytics tab also shows outcome results by variant when outcome analysis is turned on for the server.
  • A copy button next to the title copies the flag key.
  • Rolling back, moving, archiving, restoring and deleting a flag each ask for confirmation in a dialog that stays open, with its buttons off, until the change is saved. If it fails, the dialog stays so you can try again or cancel.