Platform feature flags are the platform team's own switches for the console — for example hiding the Build with AI menu item without removing it. They are separate from the feature flags your customers create for their apps: customers' flags live in their org and are read by their apps; platform flags belong to the platform and are read by the console.
Where to manage them
Platform admin console → Platform Flags (platform admins and platform developers). It is the same editor your customers use: on/off, a default value or percentage split, individual users, rules, scheduled changes and a live window, plus a Test tab that shows what a given user would get.
Targeting who sees what
| Fact you can use in a rule | Example |
|---|---|
roles (comma-separated) or role | roles contains developer |
org | org is one of acme |
email | email ends with @acme.com |
platformRole | platformRole is one of platform_admin |
authenticated (true / false) | authenticated is one of false — the sign-in page, before anyone is signed in |
key (the user id) and now | now is after a date |
Hiding Build with AI
The console already knows the flag show-build-with-ai. Create it (new environments already have it) and turn it Off: the left menu item, the Build with AI page (it redirects to the dashboard) and the shortcut on the MCP page all disappear. Turn it On to bring them back. The change reaches the console within about five minutes, sooner for a scheduled change.
Built-in defaults protect the console
Every flag the console uses has a built-in default. If a flag does not exist, or the flags route cannot be reached, the console behaves as it ships — so deleting a flag, or a short outage, never breaks anything.
Not for secrets
Platform flags are read by the console before and after sign-in. Use them for switches, never for keys or private values.
For developers
Add the flag to the console's list of known flags (with its built-in default), read it with useFeatureFlag('your-flag') or wrap UI in <FeatureGate flag="your-flag">, tie a menu item to it with featureFlag in the nav config, and then create a flag with the same key under Platform Flags. The Platform Flags page lists flags the console uses that do not exist yet.