--- description: Wrangler commands for managing Workers Queues configurations. title: Queues image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-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. # Queues Last updated Apr 23, 2026|Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/workers/wrangler/commands/queues/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/) Manage your Workers [Queues](https://developers.cloudflare.com/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

- --vboolean alias: --version Show version number - --cwdstringRun as if Wrangler was started in the specified directory instead of the current working directory - --configstring alias: --c Path to Wrangler configuration file - --envstring alias: --e Environment to use for operations, and for selecting .env and .dev.vars files - --env-filestringPath to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - --experimental-provisionboolean aliases: --x-provisiondefault: true Experimental: Enable automatic resource provisioning - --experimental-auto-createboolean alias: --x-auto-createdefault: true Automatically provision draft bindings with new resources - --install-skillsboolean default: false Install Cloudflare skills for detected AI coding agents before running the command - --profilestringUse a specific auth profile

## `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 - `--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

## `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

## `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

## `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

## `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

## `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

## `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

## `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

## `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

## `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

## `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 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

## `queues consumer worker remove` Remove a Queue Worker Consumer npmyarnpnpm ``` npx wrangler queues consumer worker remove [QUEUE-NAME] [SCRIPT-NAME] ``` ``` yarn wrangler queues consumer worker remove [QUEUE-NAME] [SCRIPT-NAME] ``` ``` pnpm wrangler queues consumer worker 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

## `queues consumer worker list` List worker consumers for a queue npmyarnpnpm ``` npx wrangler queues consumer worker list [QUEUE-NAME] ``` ``` yarn wrangler queues consumer worker list [QUEUE-NAME] ``` ``` pnpm wrangler queues consumer worker list [QUEUE-NAME] ``` - `[QUEUE-NAME]` `string` required Name of the queue - `--json` `boolean` default: false Output in JSON format

Global flags

## `queues pause-delivery` Pause message delivery for a queue npmyarnpnpm ``` npx wrangler queues pause-delivery [NAME] ``` ``` yarn wrangler queues pause-delivery [NAME] ``` ``` pnpm wrangler queues pause-delivery [NAME] ``` - `[NAME]` `string` required The name of the queue

Global flags

## `queues resume-delivery` Resume message delivery for a queue npmyarnpnpm ``` npx wrangler queues resume-delivery [NAME] ``` ``` yarn wrangler queues resume-delivery [NAME] ``` ``` pnpm wrangler queues resume-delivery [NAME] ``` - `[NAME]` `string` required The name of the queue

Global flags

## `queues purge` Purge messages from a queue npmyarnpnpm ``` npx wrangler queues purge [NAME] ``` ``` yarn wrangler queues purge [NAME] ``` ``` pnpm wrangler queues purge [NAME] ``` - `[NAME]` `string` required The name of the queue - `--force` `boolean` Skip the confirmation dialog and forcefully purge the Queue

Global flags

## `queues subscription create` Create a new event subscription for a queue npmyarnpnpm ``` npx wrangler queues subscription create [QUEUE] ``` ``` yarn wrangler queues subscription create [QUEUE] ``` ``` pnpm wrangler queues subscription create [QUEUE] ``` - `[QUEUE]` `string` required The name of the queue to create the subscription for - `--source` `string` required The event source type - `--events` `string` required Comma-separated list of event types to subscribe to - `--name` `string` Name for the subscription (auto-generated if not provided) - `--enabled` `boolean` default: true Whether the subscription should be active - `--model-name` `string` Workers AI model name (required for workersAi.model source) - `--worker-name` `string` Worker name (required for workersBuilds.worker source) - `--workflow-name` `string` Workflow name (required for workflows.workflow source) - `--zone-id` `string` Zone ID (required for email.sending source) - `--domain` `string` Sending domain — zone apex or verified subdomain (required for email.sending source)

Global flags

## `queues subscription list` List event subscriptions for a queue npmyarnpnpm ``` npx wrangler queues subscription list [QUEUE] ``` ``` yarn wrangler queues subscription list [QUEUE] ``` ``` pnpm wrangler queues subscription list [QUEUE] ``` - `[QUEUE]` `string` required The name of the queue to list subscriptions for - `--page` `number` default: 1 Page number for pagination - `--per-page` `number` default: 20 Number of subscriptions per page - `--json` `boolean` default: false Output in JSON format

Global flags

## `queues subscription get` Get details about a specific event subscription npmyarnpnpm ``` npx wrangler queues subscription get [QUEUE] ``` ``` yarn wrangler queues subscription get [QUEUE] ``` ``` pnpm wrangler queues subscription get [QUEUE] ``` - `[QUEUE]` `string` required The name of the queue - `--id` `string` required The ID of the subscription to retrieve - `--json` `boolean` default: false Output in JSON format

Global flags

## `queues subscription delete` Delete an event subscription from a queue npmyarnpnpm ``` npx wrangler queues subscription delete [QUEUE] ``` ``` yarn wrangler queues subscription delete [QUEUE] ``` ``` pnpm wrangler queues subscription delete [QUEUE] ``` - `[QUEUE]` `string` required The name of the queue - `--id` `string` required The ID of the subscription to delete - `--force` `boolean` alias: --ydefault: false Skip confirmation

Global flags

## `queues subscription update` Update an existing event subscription npmyarnpnpm ``` npx wrangler queues subscription update [QUEUE] ``` ``` yarn wrangler queues subscription update [QUEUE] ``` ``` pnpm wrangler queues subscription update [QUEUE] ``` - `[QUEUE]` `string` required The name of the queue - `--id` `string` required The ID of the subscription to update - `--name` `string` New name for the subscription - `--events` `string` Comma-separated list of event types to subscribe to - `--enabled` `boolean` Whether the subscription should be active - `--json` `boolean` default: false Output in JSON format

Global flags

Was this helpful? YesNo ## On this page [![](https://developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/queues/#page","headline":"Queues · Cloudflare Workers docs","description":"Wrangler commands for managing Workers Queues configurations.","url":"https://developers.cloudflare.com/workers/wrangler/commands/queues/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-04-23","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/"}} ```