Products · Developer platform
Flagship
Feature flags evaluated at the edge for Cloudflare Workers
Pricing and limits
Limits
As of Nov 3, 2026, from Cloudflare's docs, last updated there Oct 19, 2026. Licensed CC BY 4.0; navigation removed.
Flagship enforces the following limits.
Platform limits
| Feature | Limit |
|---|---|
| Apps per account | 10,000 |
| Flags per app | 5,000 |
| Flag, app, and variant keys | 64 chars |
| Condition attribute names | 64 chars |
| Condition string values | 256 chars |
| Variant value size | 10 KB |
| Condition grouping depth | 5 levels |
| Flag description | 512 chars |
| Flag configuration size per app | 25 MB |
Note
The apps-per-account and flags-per-app limits are soft limits. If your use case requires higher limits, contact Cloudflare support.
Evaluation context limits
The following limits apply to each evaluation context:
| Feature | Limit | Scope |
|---|---|---|
| Top-level attributes | 100 | All evaluation paths |
| Top-level key length | 1–256 chars | All evaluation paths |
| Value nesting depth | 10 levels | All evaluation paths |
| Serialized UTF-8 JSON size | 32 KiB | All evaluation paths |
| Values visited during traversal | 10,000 values | Data-plane HTTP and Workers binding only |
Notes
- Condition grouping depth counts from the top-level condition group. A flat list of conditions has a depth of one.
- Context value nesting and attribute path traversal use separate limits. Targeting attribute paths can contain up to five segments.
- Flag keys, app names, condition set names, and variant keys can contain letters, numbers, hyphens, and underscores.
- All variants on a flag must use the same value type: boolean, string, number, or JSON.
- Flag configuration size refers to the total serialized size of all flags within a single app, including their variants and rules.
Timeline
November 2026
- Evaluate Flagship flags locally
Flagship bindings now evaluate flags against a local flag store during local development, instead of calling your remote app. You can develop offline and test flag changes without affecting production. This applies to wrangler dev, the Cloudflare Vite plugin, the Vitest integration, and cf dev. The local store starts empty, so evaluations return the default value you pass in code. Add and manage…
October 2026
- Target Flagship feature flags with structured evaluation context
Flagship supports nested objects, arrays, and null in evaluation context. Pass user profiles and tag lists directly, then target nested attributes without flattening your application data. For example, pass a profile and tags when evaluating a flag through the Workers binding: const enabled = await env.FLAGS.getBooleanValue("new-checkout", false, { targetingKey: "user-42", profile: { plan: "enter…
August 2026
- Create app-scoped API tokens for Flagship
You can now create app-scoped API tokens for Flagship. These tokens grant access only to the Flagship apps you select, instead of every app in the account. When you create a custom token, open the resource dropdown (it defaults to Entire Account) and select Specified Flagship apps. Then choose the app and a Flagship App permission: Evaluate, Read, or Write. Account-wide Flagship Evaluate, Read, a…
July 2026
- Manage Flagship from the command line with Wrangler
Wrangler now includes wrangler flagship, a command suite for managing Flagship apps and feature flags from your terminal. Create an app and, if you use it from a Worker, add it to your wrangler.json or wrangler.jsonc file as a binding: wrangler flagship apps create "My Worker App" \ --binding FLAGS \ --update-config Then create flags for the behavior you want to control. Flags can be booleans, st…
June 2026
- Flagship API reference now available
The Flagship API reference is now available. You can use the Cloudflare API to create and update apps, and to create, update, delete, and list feature flags without using the dashboard. For example, create a new boolean flag with the API: curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/flagship/apps/$APP_ID/flags \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CL…
May 2026
- Flagship now in public beta
Flagship is now in public beta. Evaluate feature flags directly from Cloudflare Workers with no outbound HTTP calls, using globally distributed flag configuration backed by Workers KV and Durable Objects. Flagship supports typed flag values, targeting rules, percentage rollouts, audit history, and OpenFeature-compatible SDKs. Evaluate a flag from a Worker in a few lines of code: src/index.jsjsexp…