Feature Flags
Manage per-environment typed feature flags and promote them across environments.
Feature flags store typed toggles (boolean, string, number, or JSON) per workspace environment in the Control Plane. Use them to gate behavior without redeploying, then promote values from dev → staging → prod.
Runtime SDKs (for example GrowthBook clients) are not wired yet. Flags are managed and promoted in the portal and API; your app reads them via Control Plane until an SDK path ships.
Who can access
| Action | Typical permission |
|---|---|
| List / compare flags | read |
| Create / update / delete / promote | write |
Prerequisites
- Workspace selected in the top navigation picker
- Target environment selected on the flags page (dev, staging, or prod)
Manage flags
Open Feature flags
In the sidebar under Build, click Feature flags.
Select workspace and environment
Flags are scoped to one environment at a time.
Add or edit a flag
Keys should be lowercase with hyphens (for example new-checkout). Choose a type and value, then save.
Promote flags
Open Environments under Build, choose source and target environments, and use the feature-flags promote panel. The diff shows flag values (unlike secrets, where values stay hidden).
See Environment Promotion for the full promote flow.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Flag missing after create | Wrong environment | Confirm the environment selector |
| Promote skipped a key | Target already has a value with skip policy | Re-run with overwrite, or edit the target |
| 403 on upsert | Missing write | Check Members & Roles |
Related API
GET/PUT/DELETE /v1/workspaces/{id}/flags[/{key}]?environment_id=GET /v1/workspaces/{id}/flags/comparePOST /v1/workspaces/{id}/flags/promote
Related
- Environment Promotion
- Secrets — separate config channel (values never shown in diffs)