Skip to content

Queues

Last updated View as MarkdownAgent setup

Manage your Workers Queues configurations using Wrangler.

queues list

List queues

npx wrangler queues list
  • --pagenumber

    Page number for pagination

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues create

Create a queue

npx wrangler queues create <NAME>
  • <NAME>string required

    The name of the queue

  • --jurisdictionstring

    The jurisdiction of the queue

  • --delivery-delay-secsnumber

    How long a published message should be delayed for, in seconds. Must be between 0 and 86400

  • --message-retention-period-secsnumber

    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

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues update

Update a queue

npx wrangler queues update <NAME>
  • <NAME>string required

    The name of the queue

  • --delivery-delay-secsnumber

    How long a published message should be delayed for, in seconds. Must be between 0 and 86400

  • --message-retention-period-secsnumber

    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

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues delete

Delete a queue

npx wrangler queues delete <NAME>
  • <NAME>string required

    The name of the queue

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues info

Get queue information

npx wrangler queues info <NAME>
  • <NAME>string required

    The name of the queue

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer add

Add a Queue Worker Consumer

npx 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-sizenumber

    Maximum number of messages per batch

  • --batch-timeoutnumber

    Maximum number of seconds to wait to fill a batch with messages

  • --message-retriesnumber

    Maximum number of retries for each message

  • --dead-letter-queuestring

    Queue to send messages that failed to be consumed

  • --max-concurrencynumber

    The maximum number of concurrent consumer Worker invocations. Must be a positive integer

  • --retry-delay-secsnumber

    The number of seconds to wait before retrying a message

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer remove

Remove a Queue Worker Consumer

npx 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

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer list

List consumers for a queue

npx wrangler queues consumer list <QUEUE-NAME>
  • <QUEUE-NAME>string required

    Name of the queue

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer http add

Add a Queue HTTP Pull Consumer

npx wrangler queues consumer http add <QUEUE-NAME>
  • <QUEUE-NAME>string required

    Name of the queue for the consumer

  • --batch-sizenumber

    Maximum number of messages per batch

  • --message-retriesnumber

    Maximum number of retries for each message

  • --dead-letter-queuestring

    Queue to send messages that failed to be consumed

  • --visibility-timeout-secsnumber

    The number of seconds a message will wait for an acknowledgement before being returned to the queue.

  • --retry-delay-secsnumber

    The number of seconds to wait before retrying a message

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer http remove

Remove a Queue HTTP Pull Consumer

npx wrangler queues consumer http remove <QUEUE-NAME>
  • <QUEUE-NAME>string required

    Name of the queue for the consumer

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer http list

List HTTP pull consumers for a queue

npx wrangler queues consumer http list <QUEUE-NAME>
  • <QUEUE-NAME>string required

    Name of the queue

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer worker add

Add a Queue Worker Consumer

npx 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-sizenumber

    Maximum number of messages per batch

  • --batch-timeoutnumber

    Maximum number of seconds to wait to fill a batch with messages

  • --message-retriesnumber

    Maximum number of retries for each message

  • --dead-letter-queuestring

    Queue to send messages that failed to be consumed

  • --max-concurrencynumber

    The maximum number of concurrent consumer Worker invocations. Must be a positive integer

  • --retry-delay-secsnumber

    The number of seconds to wait before retrying a message

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer worker remove

Remove a Queue Worker Consumer

npx 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

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues consumer worker list

List worker consumers for a queue

npx wrangler queues consumer worker list <QUEUE-NAME>
  • <QUEUE-NAME>string required

    Name of the queue

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues pause-delivery

Pause message delivery for a queue

npx wrangler queues pause-delivery <NAME>
  • <NAME>string required

    The name of the queue

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues resume-delivery

Resume message delivery for a queue

npx wrangler queues resume-delivery <NAME>
  • <NAME>string required

    The name of the queue

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues purge

Purge messages from a queue

npx wrangler queues purge <NAME>
  • <NAME>string required

    The name of the queue

  • --forceboolean

    Skip the confirmation dialog and forcefully purge the Queue

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues subscription create

Create a new event subscription for a queue

npx wrangler queues subscription create <QUEUE>
  • <QUEUE>string required

    The name of the queue to create the subscription for

  • --sourcestring required

    The event source type

  • --eventsstring required

    Comma-separated list of event types to subscribe to

  • --namestring

    Name for the subscription (auto-generated if not provided)

  • --enabledboolean default: true

    Whether the subscription should be active

  • --model-namestring

    Workers AI model name (required for workersAi.model source)

  • --worker-namestring

    Worker name (required for workersBuilds.worker source)

  • --workflow-namestring

    Workflow name (required for workflows.workflow source)

  • --zone-idstring

    Zone ID (required for email.sending source)

  • --domainstring

    Sending domain — zone apex or verified subdomain (required for email.sending source)

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues subscription list

List event subscriptions for a queue

npx wrangler queues subscription list <QUEUE>
  • <QUEUE>string required

    The name of the queue to list subscriptions for

  • --pagenumber default: 1

    Page number for pagination

  • --per-pagenumber default: 20

    Number of subscriptions per page

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues subscription get

Get details about a specific event subscription

npx wrangler queues subscription get <QUEUE>
  • <QUEUE>string required

    The name of the queue

  • --idstring required

    The ID of the subscription to retrieve

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues subscription delete

Delete an event subscription from a queue

npx wrangler queues subscription delete <QUEUE>
  • <QUEUE>string required

    The name of the queue

  • --idstring required

    The ID of the subscription to delete

  • --forceboolean alias: --ydefault: false

    Skip confirmation

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

queues subscription update

Update an existing event subscription

npx wrangler queues subscription update <QUEUE>
  • <QUEUE>string required

    The name of the queue

  • --idstring required

    The ID of the subscription to update

  • --namestring

    New name for the subscription

  • --eventsstring

    Comma-separated list of event types to subscribe to

  • --enabledboolean

    Whether the subscription should be active

  • --jsonboolean default: false

    Output in JSON format

Global flags

  • --vboolean alias: --version

    Show version number

  • --cwdstring

    Run 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-filestring

    Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files

  • --install-skillsboolean default: false

    Install Cloudflare skills for detected AI coding agents before running the command

  • --profilestring

    Use a specific auth profile

Was this helpful?