Troubleshooting

The bar never appears

The bar only shows while there’s queue activity, so first confirm there actually is any. A few things to check:

• Is a job actually running or waiting? With no activity, the bar stays hidden by design.
• If you only have waiting jobs, is Count waiting jobs as activity enabled in Settings → Queuebert?
• Is the plugin installed and enabled? Check Settings → Plugins.
• Give it a moment — the poller checks on an interval (default 3 seconds), so the bar can take a poll cycle to appear.

The bar is slow to react

Lower the Poll interval in Settings → Queuebert for a snappier response while you’re watching. Remember the poller intentionally backs off when the tab is hidden, so switch back to the tab to see live updates.

A custom queue isn’t showing up

Queuebert picks up any application component implementing craft\queue\QueueInterface. Make sure your custom queue is registered as a component in config/app.php and that it implements that interface. See Custom Queues for a working example.

Failed jobs aren’t turning the bar red

Confirm Surface failed jobs is enabled in Settings → Queuebert. If it’s off, failed jobs won’t change the bar’s color.

The bar is affecting control-panel performance

Raise the Poll interval so activity checks happen less often, and lower the Inspect limit so Queuebert inspects fewer jobs per queue when building its summary. Both reduce the work done on each poll.

Does Queuebert run my jobs?

No. Queuebert is strictly read-only — it reports queue state but never runs, retries, or triggers jobs. If jobs aren’t processing, that’s a queue-runner concern (for example your queue/listen or web-based runner), not Queuebert.

Still need help?

Open an issue on GitHub with details about your problem and we’ll help you out.