Wrangler commands (8)

Wrangler commands (8)

Last updated Apr 21, 2026 Queues Wrangler commands use REST APIs to interact with the control plane. This page lists the Wrangler commands for Queues.

`queues list`

List queues

npmyarnpnpm

npx wrangler queues list

yarn wrangler queues list

pnpm wrangler queues list

--page number Page number for pagination

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>

`queues create`

Create a queue

npmyarnpnpm

npx wrangler queues create <NAME>

yarn wrangler queues create <NAME>

pnpm wrangler queues create <NAME>

<NAME> string required

The name of the queue - --jurisdiction string The jurisdiction of the queue - --delivery-delay-secs number How long a published message should be delayed for, in seconds. Must be between 0 and 86400 - --message-retention-period-secs number How long to retain a message in the queue, in seconds. Must be between 60 and 86400 if on free tier, otherwise must be between 60 and 1209600

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues update`

Update a queue

npmyarnpnpm

npx wrangler queues update <NAME>

yarn wrangler queues update <NAME>

pnpm wrangler queues update <NAME>

<NAME> string required

The name of the queue - --delivery-delay-secs number How long a published message should be delayed for, in seconds. Must be between 0 and 86400 - --message-retention-period-secs number How long to retain a message in the queue, in seconds. Must be between 60 and 86400 if on free tier, otherwise must be between 60 and 1209600

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues delete`

Delete a queue

npmyarnpnpm

npx wrangler queues delete <NAME>

yarn wrangler queues delete <NAME>

pnpm wrangler queues delete <NAME>

<NAME> string required

The name of the queue

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues info`

Get queue information

npmyarnpnpm

npx wrangler queues info <NAME>

yarn wrangler queues info <NAME>

pnpm wrangler queues info <NAME>

<NAME> string required

The name of the queue

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer add`

Add a Queue Worker Consumer

npmyarnpnpm

npx wrangler queues consumer add <QUEUE-NAME> <SCRIPT-NAME>

yarn wrangler queues consumer add <QUEUE-NAME> <SCRIPT-NAME>

pnpm wrangler queues consumer add <QUEUE-NAME> <SCRIPT-NAME>

<QUEUE-NAME> string required

Name of the queue to configure - <SCRIPT-NAME> string required

Name of the consumer script - --batch-size number Maximum number of messages per batch - --batch-timeout number Maximum number of seconds to wait to fill a batch with messages - --message-retries number Maximum number of retries for each message - --dead-letter-queue string Queue to send messages that failed to be consumed - --max-concurrency number The maximum number of concurrent consumer Worker invocations. Must be a positive integer - --retry-delay-secs number The number of seconds to wait before retrying a message

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer remove`

Remove a Queue Worker Consumer

npmyarnpnpm

npx wrangler queues consumer remove <QUEUE-NAME> <SCRIPT-NAME>

yarn wrangler queues consumer remove <QUEUE-NAME> <SCRIPT-NAME>

pnpm wrangler queues consumer remove <QUEUE-NAME> <SCRIPT-NAME>

<QUEUE-NAME> string required

Name of the queue to configure - <SCRIPT-NAME> string required

Name of the consumer script

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer list`

List consumers for a queue

npmyarnpnpm

npx wrangler queues consumer list <QUEUE-NAME>

yarn wrangler queues consumer list <QUEUE-NAME>

pnpm wrangler queues consumer list <QUEUE-NAME>

<QUEUE-NAME> string required

Name of the queue - --json boolean default: false

Output in JSON format

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer http add`

Add a Queue HTTP Pull Consumer

npmyarnpnpm

npx wrangler queues consumer http add <QUEUE-NAME>

yarn wrangler queues consumer http add <QUEUE-NAME>

pnpm wrangler queues consumer http add <QUEUE-NAME>

<QUEUE-NAME> string required

Name of the queue for the consumer - --batch-size number Maximum number of messages per batch - --message-retries number Maximum number of retries for each message - --dead-letter-queue string Queue to send messages that failed to be consumed - --visibility-timeout-secs number The number of seconds a message will wait for an acknowledgement before being returned to the queue. - --retry-delay-secs number The number of seconds to wait before retrying a message

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer http remove`

Remove a Queue HTTP Pull Consumer

npmyarnpnpm

npx wrangler queues consumer http remove <QUEUE-NAME>

yarn wrangler queues consumer http remove <QUEUE-NAME>

pnpm wrangler queues consumer http remove <QUEUE-NAME>

<QUEUE-NAME> string required

Name of the queue for the consumer

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer http list`

List HTTP pull consumers for a queue

npmyarnpnpm

npx wrangler queues consumer http list <QUEUE-NAME>

yarn wrangler queues consumer http list <QUEUE-NAME>

pnpm wrangler queues consumer http list <QUEUE-NAME>

<QUEUE-NAME> string required

Name of the queue - --json boolean default: false

Output in JSON format

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e

Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile

</details>

`queues consumer worker add`

Add a Queue Worker Consumer

npmyarnpnpm

npx wrangler queues consumer worker add <QUEUE-NAME> <SCRIPT-NAME>

yarn wrangler queues consumer worker add <QUEUE-NAME> <SCRIPT-NAME>

pnpm wrangler queues consumer worker add <QUEUE-NAME> <SCRIPT-NAME>

<QUEUE-NAME> string required

Name of the queue to configure - <SCRIPT-NAME> string required

Global flags

</summary>

<code>--v</code><code>boolean</code> alias: --version

Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e