For AI agents: the complete documentation index is available at /worker-manager/llms.txt, the full documentation bundle is available at /worker-manager/llms-full.txt, and this page is available as Markdown at /worker-manager/recipes/global-concurrency.md.

Global concurrency

BullMQ supports a global cap on concurrent jobs across all workers for a queue. The dashboard can read and change it.

Set from the UI

Open the queue's actions dropdown, pick Set concurrency, enter a number. The current value is shown in the queue info panel, under Global concurrency.

Worker Manager calls Queue.setGlobalConcurrency(n) on your behalf. Workers respect the new cap on their next job pickup. Setting it to 0 removes the limit.

Set in code

await queue.setGlobalConcurrency(5);

The value is stored in Redis so any worker across any process sees it.

Bull-only queues: global concurrency isn't supported. The UI hides the control.

Read-only mode

Read-only mode disables the control. If you want stakeholders to see the number but not change it, readOnlyMode: true is the switch.