Skip to main content

BullMQPluginOptions

Configuration options for the BullMQJobQueuePlugin.

Signature

connection

propertyConnectionOptions

Connection options which will be passed directly to BullMQ when creating a new Queue, Worker and Scheduler instance.

If omitted, it will attempt to connect to Redis at 127.0.0.1:6379.

queueOptions

propertyOmit<QueueOptions, 'connection'>

Additional options used when instantiating the BullMQ Queue instance. See the BullMQ QueueOptions docs

workerOptions

propertyOmit<WorkerOptions, 'connection'>

Additional options used when instantiating the BullMQ Worker instance. See the BullMQ WorkerOptions docs

setRetries

property(queueName: string, job: Job) => numberv1.3.0

When a job is added to the JobQueue using JobQueue.add(), the calling code may specify the number of retries in case of failure. This option allows you to override that number and specify your own number of retries based on the job being added.

Example

Ts

setBackoff

property(queueName: string, job: Job) => BackoffOptions | undefinedv1.3.0
Default:'exponential', 1000

This allows you to specify the backoff settings when a failed job gets retried. In other words, this determines how much time should pass before attempting to process the failed job again. If the function returns undefined, the default value of exponential/1000ms will be used.

Example

Ts

setJobOptions

property(queueName: string, job: Job) => BullJobsOptionsv3.2.0

This allows you to specify additional options for a job when it is added to the queue. The object returned is the BullMQ JobsOptions type, which includes control over settings such as delay, attempts, priority and much more.

This function is called every time a job is added to the queue, so you can return different options based on the job being added.

Example

Ts

Configuration for the backoff function when retrying failed jobs.

Signature

type

property'exponential' | 'fixed'

delay

propertynumber
Was this chapter helpful?
Report Issue
Edited Feb 23, 2026ยทEdit this page