n8n 2.48: what's new and should you upgrade

n8n 2.48.0 was released on November 10, 2026 on the beta track. It's a quieter release than 2.47: n8n Assistant's default model moves to Claude Opus 5.5, the 3.0 Migration Report gets easier to work through, and a fix makes the redaction policy apply to log streaming, telemetry and error reports. For production, the stable release is now 2.47.3.

The short version

• Which version to run: on November 11, 2026, npm's stable and latest tags point to 2.47.3, and beta and next to 2.48.0.
• n8n Assistant: the default model for N8N_INSTANCE_AI_MODEL changes from anthropic/claude-opus-4-8 to anthropic/claude-opus-5-5.
• Migration Report: archived workflows are hidden by default, notification emails open the report filtered to the recipient, and a message appears when it takes long to load.
• Redaction: the policy now also applies to log streaming, telemetry and error reports.
• Renamed node: Paddle is now Paddle Classic; existing workflows keep working.
• Our upgrade test: a 2.46.7 instance upgraded to 2.48.0, ran 22 database migrations, and a Code node workflow returned the same results.

Should you upgrade?

• Production instances: move to 2.47.3, the new stable release, if you're still on 2.46. Our n8n 2.47 roundup covers what changed.
• Test or staging instances: try 2.48.0 if you use n8n Assistant, stream logs with redaction turned on, or are working through the Migration Report for 3.0.

Pin the exact version in Docker Compose, and give the task runner the same tag:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:2.48.0
  task-runners:
    image: n8nio/runners:2.48.0

Take a backup before you upgrade. Our guide on how to update self-hosted n8n safely has the steps, and n8n stable vs beta explains the release tracks.

n8n Assistant now defaults to Claude Opus 5.5

The 2.48.0 changelog lists "Bump the default Assistant model to Claude Opus 5.5". In n8n's source, the default of N8N_INSTANCE_AI_MODEL (the Assistant's model, in provider/model format) changed from anthropic/claude-opus-4-8 in 2.47.0 to anthropic/claude-opus-5-5.

This matters if you run the Assistant on a self-hosted instance with your own Anthropic key and never set the variable: after the upgrade, its requests go to the newer model. To keep the old one, set it explicitly:

services:
  n8n:
    environment:
      - N8N_INSTANCE_AI_MODEL=anthropic/claude-opus-4-8

2.47 added the on/off switch for the Assistant (N8N_INSTANCE_AI_ENABLED); see the 2.47 roundup. We didn't test the Assistant itself.

Migration Report updates for 3.0

The Migration Report is n8n's checklist of what to fix before 3.0. In 2.48.0, per the changelog:

• Archived workflows are hidden by default.
• Notification emails open the report filtered to the recipient, so each person sees their own findings.
• A message appears when the report takes long to load.
• Only users who can edit a workflow can own its migration findings.

For every breaking change and when 3.0 is due, see n8n 3.0 breaking changes and how to prepare.

Redaction now covers logs, telemetry and error reports

One fix is worth a look if you use execution data redaction: 2.48.0 will "apply the redaction policy to log streaming, telemetry and error reports", per the changelog. It's listed as a bug fix, so on earlier versions those outputs may carry data the policy is meant to hide. If you redact executions because they contain personal or secret data and also stream logs to an external system, this is the reason to plan the upgrade. A related fix shows the reason a credential is redacted even to users without sharing permission.

Also new in 2.48.0

• Paddle node renamed to Paddle Classic. In the node source only the display name changed; the internal name is still paddle, so existing workflows keep working.
• Microsoft Work IQ OAuth2 API, a new credential type.
• Logout events: n8n now emits telemetry and audit events when a user logs out.
• Gateway credits: Agent runs stop when the Gateway credits wallet is empty.
• Credential modal: shows a callout when a credential is restricted.
• Apps: more early work (element selection in the Apps preview, app bindings, links between Apps and Assistant chats). As in 2.47, the apps module isn't in n8n's default module list, so a standard instance doesn't load it.

Fixes worth knowing about

From the 2.48.0 changelog:

• npm install of n8n works on all platforms again.
• Webhook bodies are decoded in the charset the request declares.
• Continue On Fail is honored for initial connection errors.
• Retry backoff is kept when a trigger fails right after reactivation.
• Anthropic thinking stays valid in agents after prompt rewrites and web search.
• Sub-workflow errors keep their warning level when rebuilt for the parent.
• Compression node keeps custom gzip file names, and the RabbitMQ node waits for queue bindings before returning the channel.
• Google Drive document IDs are extracted from Drive URLs, and API version headers are preserved regardless of case.
• Multer (the upload library) is updated to 2.5.0.

What we saw when we upgraded

On November 11 we took a test instance running n8n 2.46.7 on SQLite, with a workflow made of a JavaScript Code node and an Edit Fields (Set) node with an expression, and ran the same workflow from the command line on 2.46.7 and then on 2.48.0:

• 22 database migrations ran when 2.48.0 started on the 2.46.7 database. That count covers the changes in 2.47 and 2.48, because we skipped 2.47.
• The workflow returned the same three items on both versions.

This was a small test instance started from the npm package, not Docker, so it says nothing about migration time on a large Postgres database.

For all release coverage, see the releases tag.