Manage Flagship apps and feature flags from the terminal

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:

<div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>apps</span><span> </span><span>create</span><span> </span><span>"My Worker App"</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--binding</span><span> </span><span>FLAGS</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--update-config</span></div></div>

Then create flags for the behavior you want to control. Flags can be booleans, strings, numbers, or JSON values:

<div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>create</span><span> </span><span><APP_ID></span><span> </span><span>new-checkout</span></div></div><div><div>
</div></div><div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>create</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--variation</span><span> </span><span>control=old-checkout</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--variation</span><span> </span><span>treatment=new-checkout</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--default</span><span> </span><span>control</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--type</span><span> </span><span>string</span></div></div>

After a flag exists, change its default variation or use enable and disable commands as kill switches. Existing targeting rules continue to apply unless you change or clear them explicitly:

<div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>update</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span><span> </span><span>--default</span><span> </span><span>treatment</span></div></div><div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>disable</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span></div></div><div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>enable</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span></div></div>

For release workflows, use rollout, split, and rules to change exposure without redeploying your Worker:

<div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>rollout</span><span> </span><span><APP_ID></span><span> </span><span>new-checkout</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--to</span><span> </span><span>on</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--percentage</span><span> </span><span>25</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--by</span><span> </span><span>user_id</span></div></div><div><div>
</div></div><div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>split</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--weight</span><span> </span><span>control=</span><span>80</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--weight</span><span> </span><span>treatment=</span><span>20</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--by</span><span> </span><span>user_id</span></div></div><div><div>
</div></div><div><div><span>wrangler</span><span> </span><span>flagship</span><span> </span><span>flags</span><span> </span><span>rules</span><span> </span><span>update</span><span> </span><span><APP_ID></span><span> </span><span>checkout-flow</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--priority</span><span> </span><span>1</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>--when</span><span> </span><span>"country equals US"</span></div></div>

These commands can also be used from CI/CD pipelines, scripts, and AI agents to inspect Flagship state, update flag behavior, or roll back changes through Wrangler.

Refer to the wrangler flagship command reference for the full command guide.