Skip to content
FlagSwiftDocs

Environments

Add, rename, reorder and protect the stages your flags move through.

What this page is for#

An environment is a stage of delivery such as development, staging or production. Every flag exists in every environment, and each environment keeps its own on or off state and targeting. This page lists them and lets you manage the custom ones.

In the console it lives at /environments. Everyone signed in can open it.

What you can do#

  • Create an environment

    Choose a name and a key, and mark it as a production environment if it should be protected.

  • Edit an environment

    Rename it, change the production setting, or require approval for changes made there.

  • Reorder environments

    Drag a row, or use the up and down buttons. The order sets the column order on the flags table.

  • Remove an environment

    The confirmation shows how many flags it affects and asks you to type the key. The dialog stays open until the removal finishes.

  • Search

    Filter the list by name or key.

Good to know#

  • A new environment is added, switched off, to every existing flag, and flags you create later include it automatically.
  • Production environments let developers view but not change flags. Release managers and admins keep full access.
  • With Require approval on, changes are made by proposing a release that a reviewer approves. The kill switch still works at once.
  • The key is used by SDKs and flag history, so it cannot be changed after creation. Removing an environment also removes its change history.
  • Rows show Default, Production and Approval required badges. Create, edit and remove need environments.create, environments.update and environments.delete.