Fix 3 Incorrect Queue Type Errors in n8n Queue Mode

Who this is for: n8n administrators and developers troubleshooting queue‑backend mismatches in production or self‑hosted deployments. We cover this in detail in the n8n Queue Mode Errors Guide.

Quick Diagnosis

TL;DR – Install the correct queue library (npm i bull or npm i @taskforces/bullmq), set QUEUE_TYPE accordingly, and restart the service. The error disappears.

1. Why “Incorrect queue type” Happens ?

If you encounter any n8n queue mode incorrect queue name resolve them before continuing with the setup.

Queue backend overview

When QUEUE_MODE=queue, n8n expects QUEUE_TYPE to match the installed library. A mismatch triggers the Incorrect queue type error.

EEFA note – Pin the exact queue‑library version in package.json and lock Redis to ≥ 5.0 for BullMQ. Mismatched versions can cause race‑conditions that surface as this error under load.

2. Selecting the Right Queue Backend

Decision checklist

EEFA warning – Never mix Bull and BullMQ in the same Redis DB; purge the queue when switching backends.

3. Step‑by‑Step Configuration

3.1. Using Bull (simplest)

Install

npm install bull@4.10.0   # exact version for stability

Docker‑compose environment

environment:
  - QUEUE_MODE=queue
  - QUEUE_TYPE=bull          # must match the npm package name
  - REDIS_HOST=redis
  - REDIS_PORT=6379

Restart

docker compose restart n8n

Verify – tail logs for confirmation

docker logs -f n8n | grep "Queue type"
# Expected output: "Queue type set to bull"

3.2. Using BullMQ (high‑scale)

Install

npm install @taskforces/bullmq@2.0.0   # or `bullmq` if you prefer upstream

Docker‑compose environment

environment:
  - QUEUE_MODE=queue
  - QUEUE_TYPE=bullmq
  - REDIS_HOST=redis
  - REDIS_PORT=6379
  - REDIS_TLS=false          # set true if TLS‑terminated Redis

Optional – enable job events

environment:
  - BULLMQ_ENABLE_EVENTS=true

Restart & verify

docker compose restart n8n
docker logs n8n | grep "Queue type"
# Should output: "Queue type set to bullmq"

3.3. Switching Backends (Bull ↔ BullMQ)

const Bull = require('bull');
const q = new Bull('n8n', { redis: { host: process.env.REDIS_HOST } });
await q.obliterate({ force: true });

EEFA tip – Perform the purge on a non‑production replica or during a maintenance window to avoid losing in‑flight jobs.

4. Advanced Troubleshooting

Common symptom matrix

EEFA – In clustered Redis environments, ensure every node shares the same QUEUE_TYPE. A single node running Bull while others run BullMQ will corrupt the shared job set. If you encounter any n8n queue mode incorrect priority resolve them before continuing with the setup.

5. Code Samples: Direct Queue Interaction (custom nodes)

5.1. Enqueue a job with Bull

Create the queue client

const Bull = require('bull');

const n8nQueue = new Bull('n8n', {
  redis: { host: process.env.REDIS_HOST, port: process.env.REDIS_PORT },
});

Add a job

module.exports = async function addJob(data) {
  const job = await n8nQueue.add('workflow', data, {
    attempts: 3,
    backoff: { type: 'exponential', delay: 5000 },
  });
  return job.id;
};

5.2. Enqueue a job with BullMQ

Create the queue client

const { Queue } = require('@taskforces/bullmq');

const n8nQueue = new Queue('n8n', {
  connection: {
    host: process.env.REDIS_HOST,
    port: process.env.REDIS_PORT,
  },
});

Add a job

module.exports = async function addJob(data) {
  const job = await n8nQueue.add('workflow', data, {
    attempts: 3,
    backoff: { type: 'exponential', delay: 5000 },
  });
  return job.id;
};

EEFA note – BullMQ’s Job object includes a queueName property; Bull returns only id. Adjust downstream handling accordingly.

7. Frequently Asked Questions (FAQ)

• Q1. Can I use BullMQ with a Redis Cluster?
  Yes. Set REDIS_CLUSTER=true and provide an array of node addresses; BullMQ natively supports clusters (Redis ≥ 6.0).
• Q2. Do I need to change workflow definitions when switching backends?
  No. n8n’s job payload format is backend‑agnostic; only the queue client code changes.
• Q3. Is there a performance penalty using Bull instead of BullMQ?
  Bull can be marginally faster for tiny payloads (< 1 KB) but scales poorly beyond ~1 k jobs/s. For most production workloads BullMQ is the safer bet.
• Q4. How do I monitor queue health?
  • Bull: npm i bull-board → mount at /admin/queues.
  • BullMQ: npm i @taskforces/bullmq-ui → similar UI.

  Both expose metrics (waiting, active, completed, failed) that can be scraped by Prometheus.

Conclusion

The “Incorrect queue type” error is a straightforward mismatch between the QUEUE_TYPE environment variable and the queue library actually installed. By installing the correct package (Bull or BullMQ), aligning QUEUE_TYPE, and, when necessary, purging old queue data, you restore n8n’s queue processing instantly. This fix eliminates the error, ensures reliable job execution, and keeps your production workflow stable.

Prepared by the senior SEO & technical strategy team – authoritative, production‑ready guidance.