Queues (2)·续
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 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>stringrequired
Name of the queue to configure
- <SCRIPT-NAME> string required
Name of the consumer script
<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>
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>stringrequired
Name of the queue
- --json boolean default: false
Output in JSON format
<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>
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>stringrequired
The name of the queue
<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>
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>stringrequired
The name of the queue
<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>
queues purge
Purge messages from a queue
npmyarnpnpm
npx wrangler queues purge <NAME>
yarn wrangler queues purge <NAME>
pnpm wrangler queues purge <NAME>
<NAME>stringrequired
The name of the queue
- --force boolean Skip the confirmation dialog and forcefully purge the Queue
<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>
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>stringrequired
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 (for artifacts.repo, use pushed, not cf.artifacts.repo.pushed)
- --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)
- --source-namespace string Artifacts namespace (required for artifacts.repo source)
- --source-repo-name string Artifacts repository name (required for artifacts.repo source)
<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>
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>stringrequired
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
<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>
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>stringrequired
The name of the queue
- --id string required
The ID of the subscription to retrieve
- --json boolean default: false
Output in JSON format
<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>
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>stringrequired
The name of the queue
- --id string required
The ID of the subscription to delete
- --force boolean alias: --ydefault: false
Skip confirmation
<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>
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>stringrequired
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
<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
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/queues/#page","headline":"Queues","description":"Wrangler commands for managing Workers Queues configurations.","url":"https://developers.cloudflare.com/workers/wrangler/commands/queues/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/commands/queues/og.png?v=9d24ffbf8d359acc","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/"}}
description: Wrangler commands for managing Workers R2 buckets and objects. title: R2 image: https://developers.cloudflare.com/workers/wrangler/commands/r2/og.png?v=4db980a2ba80aab2
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.
Docs