Usage

Once installed, Queuebert runs automatically on every control-panel page. There’s no section to open and no widget to add — the bar simply appears when it’s useful.

When the Bar Appears

Queuebert injects a lightweight poller into every control-panel page. On a configurable interval it asks Craft for the current queue state. When there’s activity, a slim bar slides in at the top of the control panel. When the queues go quiet, the bar animates closed and disappears.

By default, “activity” means either a job is running or jobs are waiting. You can change whether waiting jobs count toward activity in settings.

What the Bar Shows

The bar surfaces the same information Craft’s own queue HUD already exposes:

  • The current job’s description — e.g. “Resaving entries in Blog”.
  • A progress indicator for the running job, updating as it advances.
  • Counts of running, waiting, and failed jobs across every queue.
  • A link to Craft’s Queue Manager for the full picture.

Failed Jobs

When there are failed jobs and failed-job surfacing is enabled, the bar switches to an alert color so a stuck or broken job doesn’t slip past unnoticed. Head to Craft’s Queue Manager to retry or release the failed job.

All Your Queues at Once

Queuebert doesn’t just watch Craft’s default queue. It aggregates the primary queue plus every application component that implements craft\queue\QueueInterface, so custom queue runners show up in the same bar. See Custom Queues for details.

Considerate by Design

The poller automatically backs off when the queues are idle or when the browser tab is hidden, so an open control-panel tab in the background won’t hammer your server. Queuebert only ever reads queue state — it never runs, retries, or triggers jobs itself.