Flagship (2)·续2

yarn wrangler flagship flags split <APP-ID> <KEY>
pnpm wrangler flagship flags split <APP-ID> <KEY>
  • <APP-ID> string required

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> string required

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> string required

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> string required

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> string required

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> string required

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> string required

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

Flagship (2)·续2 - 图1Docs

{"@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


Skip to content

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.