Skip to content
FlagSwiftDocs

Projects

Group related flags into projects and open each project's flag list.

What this page is for#

Projects are how flags are organized. This page lists every project as a card with its flag count, and opens the flag list for a project when you pick it. A separate Manage projects page handles editing, archiving and deleting.

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

What you can do#

  • Create a project

    Give it a name, a key (letters, numbers and hyphens) and an optional description.

  • Open a project's flags

    Each card leads to the flag list for that project, where you create, filter, toggle and manage flags.

  • Find pinned projects

    Pinned projects appear in their own section above the full list.

  • Manage projects

    Search by name, key or description, and switch between Active, Archived and All.

  • Edit, archive or delete

    On the manage page you can edit a project, archive or restore it, or delete it for good. Archive, restore and delete each ask you to confirm first.

Good to know#

  • The Create button needs projects.create. Edit, archive and delete need projects.update, projects.archive and projects.delete.
  • The project's key cannot be changed after creation because API keys and SDKs use it.
  • Archiving retires a project without losing anything. An archived project's flags are read-only and its API keys are switched off. Restoring brings the flags back to editable and switches the keys back on at once. Deleting is permanent.
  • A project's flag list has filters for environment, status, type and archived flags, a search box, and a kill switch button for people who hold kill_switch.execute.