Queues (2)

Queues (2)

Last updated Apr 23, 2026 Manage your Workers Queues configurations using Wrangler.

`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