# ClusteredRedisQueue.queueLength() method · @imqueue/core

Source: https://imqueue.org/api/core/latest/core.clusteredredisqueue.queuelength/
Published: 2026-08-04
Author: @imqueue maintainers (https://github.com/imqueue)
Package: @imqueue/core 3.3.2 — generated reference, not hand-written

Returns the total number of messages waiting, summed across every redis host in the cluster.

**Signature:**

```typescript
queueLength(): Promise<number>;
```
**Returns:**

Promise<number>

sum of the per-host queue lengths

## Remarks

Resolves to `0` when the cluster has no servers, and rejects if any single host cannot be queried. As with [RedisQueue.queueLength()](https://imqueue.org/api/core/latest/core.redisqueue.queuelength/), delayed and in-flight messages are not counted.

