> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Feature Flags

> View and toggle feature flags for the current organization, controlling experimental or phased-rollout capabilities across the platform.

Feature Flags is the admin page at `/settings/feature-flags` where users with view access see the full list of feature flags scoped to their organization (including platform-wide flags). Users with `pf.feature_flags.manage` can create, edit, toggle, and delete flags.

## Overview

The page queries the `pf_feature_flags` table for flags belonging to the current organization or with a null `organization_id` (platform defaults). Each flag shows its name, enabled state via a toggle switch, and metadata. Changes are audited via `logAuditEvent`.

## Who it's for

Requires permission `pf.feature_flags.view` to access. Edit and create actions additionally require `pf.feature_flags.manage`.

## Before you start

* Confirm your role includes `pf.feature_flags.view`.
* Understand that toggling a flag may immediately affect user-visible behavior for the entire organization.

## Steps

1. Navigate to **Settings → Feature Flags** (`/settings/feature-flags`).
2. Review the flag list. The toggle switch reflects the current enabled state.
3. To enable or disable a flag, flip the toggle. The change is written immediately and logged.
4. To create a new flag, click the **Add** button and complete the form dialog.
5. To edit flag metadata, click the edit action on any row.

## Key concepts

**Organization-scoped flags** — flags with a matching `organization_id` are specific to your tenant.

**Platform-wide flags** — flags with a null `organization_id` apply across the platform. SME should confirm edit permissions for these.

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/feature-flags/pages/FeatureFlagsPage.tsx
</Accordion>