Flagship (2)·续2
yarn wrangler flagship flags split <APP-ID> <KEY>
pnpm wrangler flagship flags split <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
The key of the flag
- --weight string alias: --w
A variation weight, in the form "variation=weight" (repeatable)
- --by string Context attribute used for sticky bucketing
- --default-variation string alias: --default
Fallback variation when bucketing cannot run
- --force boolean alias: --ydefault: false
Skip the confirmation prompt when this split replaces existing targeting rules
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags rollout
Roll out one variation to a percentage of traffic
npmyarnpnpm
npx wrangler flagship flags rollout <APP-ID> <KEY>
yarn wrangler flagship flags rollout <APP-ID> <KEY>
pnpm wrangler flagship flags rollout <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
The key of the flag
- --to string required
Variation to roll out
- --percentage number required
Percentage of traffic to serve the rollout variation (0-100)
- --by string Context attribute used for sticky bucketing
- --from-variation string alias: --from
Fallback variation for the remaining traffic
- --force boolean alias: --ydefault: false
Skip the confirmation prompt when this rollout replaces existing targeting rules
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags enable
Enable a feature flag
npmyarnpnpm
npx wrangler flagship flags enable <APP-ID> <KEY>
yarn wrangler flagship flags enable <APP-ID> <KEY>
pnpm wrangler flagship flags enable <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
One or more flag keys to enable
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags disable
Disable a feature flag
npmyarnpnpm
npx wrangler flagship flags disable <APP-ID> <KEY>
yarn wrangler flagship flags disable <APP-ID> <KEY>
pnpm wrangler flagship flags disable <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
One or more flag keys to disable
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags evaluate
Evaluate a feature flag with optional context
npmyarnpnpm
npx wrangler flagship flags evaluate <APP-ID> <KEY>
yarn wrangler flagship flags evaluate <APP-ID> <KEY>
pnpm wrangler flagship flags evaluate <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
The key of the flag
- --context string aliases: --ctx, --C
Evaluation context, in the form "name=value" (repeatable)
- --targeting-key string Stable bucketing key for percentage rollouts
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags delete
Delete a feature flag from a Flagship app
npmyarnpnpm
npx wrangler flagship flags delete <APP-ID> <KEY>
yarn wrangler flagship flags delete <APP-ID> <KEY>
pnpm wrangler flagship flags delete <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
One or more flag keys to delete
- --force boolean alias: --ydefault: false
Skip the confirmation prompt
- --json boolean default: false
Return output as JSON
- --local boolean Use the local flag store instead of the remote app
- --remote boolean Use the remote app instead of the local flag store
- --persist-to string Specify directory to use for local persistence
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
flagship flags changelog
Show the changelog for a feature flag
npmyarnpnpm
npx wrangler flagship flags changelog <APP-ID> <KEY>
yarn wrangler flagship flags changelog <APP-ID> <KEY>
pnpm wrangler flagship flags changelog <APP-ID> <KEY>
<APP-ID>stringrequired
The ID of the app
- <KEY> string required
The key of the flag
- --limit number The maximum number of entries to return (1-200)
- --cursor string The pagination cursor from a previous changelog call
- --all boolean default: false
Fetch every entry, following pagination automatically
- --json boolean default: false
Return output as JSON
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
Was this helpful?
YesNo
On this page
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/flagship/#page","headline":"Flagship","description":"Wrangler commands for managing Flagship apps, feature flags, targeting rules, rollouts, evaluations, and changelog history.","url":"https://developers.cloudflare.com/workers/wrangler/commands/flagship/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/commands/flagship/og.png?v=46ac9c3713a23c1c","dateModified":"2026-07-16","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
description: General Wrangler commands for authentication, telemetry, and shell completions. title: General commands image: https://developers.cloudflare.com/workers/wrangler/commands/general/og.png?v=54c307af06ce2142
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.
Docs