Feature flags
Every flag in the organization in one list, with filters for project, environment, status and type.
What this page is for#
Feature flags lists the flags of all your projects together, with one column per environment so you can see and switch their state. A project's own flag list, opened from Projects, is the same table limited to that project. Pick a flag to open its detail page.
In the console it lives at /feature-flags. You see it in the sidebar when your role has flags.read.
What you can do#
Create a flag
Choose New Flag, pick a project, then give it a name, a key and a type.
Narrow the list
Search by name or key, and filter by project, environment, status, type and archived flags.
Sort the list
Click the Flag / Key or Updated header to sort by name or by last update; click again to reverse, and a third time to clear the sort.
See which project a flag belongs to
On this all-projects list a Project column shows each flag's project. A project's own list leaves it out.
Choose which environment columns show
Until you choose, the table shows the environments where at least one listed flag is on. If none is on, it shows the default environments, or the first three when none is marked default. Use the Columns menu to pick your own; the choice is remembered in your browser and Reset returns to the automatic columns. The environment you filter by is always shown.
Switch a flag on or off
Use the toggle in an environment's column.
Use the kill switch
People who hold kill_switch.execute get a kill switch button to switch flags off in an emergency.
Good to know#
- The page shows in the sidebar for roles with flags.read. Creating a flag needs flags.create and toggling needs flags.toggle.
- Each list keeps its own filters while you move around the console, and they are part of the page address, so a filtered list can be shared as a link.
- A project that was archived after you chose it stays in the Project filter until you pick another.