Files
n8n-docs/docs/release-notes.md
2026-03-05 15:37:09 +01:00

35 KiB
Raw Blame History

title, description, tags, hide, contentType
title description tags hide contentType
Release notes Release notes detailing new features and bug fixes for n8n.
release
release notes
changelog
tags
reference

Release notes

New features and bug fixes for n8n.

You can also view the Releases in the GitHub repository.

--8<-- "_snippets/self-hosting/installation/latest-next-version.md"

--8<-- "_snippets/update-n8n.md"

Semantic versioning in n8n

n8n uses semantic versioning. All version numbers are in the format MAJOR.MINOR.PATCH. Version numbers increment as follows:

  • MAJOR version when making incompatible changes which can require user action.
  • MINOR version when adding functionality in a backward-compatible manner.
  • PATCH version when making backward-compatible bug fixes.

/// note | Older versions You can find the release notes for older versions of n8n: 1.x and 0.x ///

n8n@2.11.1

View the commits for this version.
Release date: 2026-03-04

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.11.0

View the commits for this version.
Release date: 2026-03-02

This release contains bug fixes.

Contributors

ByteEVM
onyxraven

For full release details, refer to Releases on GitHub.

n8n@2.9.4-exp.0

View the commits for this version.
Release date: 2026-02-27

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.10.3

View the commits for this version.
Release date: 2026-03-04

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.10.2

View the commits for this version.
Release date: 2026-02-27

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.10.1

View the commits for this version.
Release date: 2026-02-25

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.10.0

View the commits for this version.
Release date: 2026-02-23

This release contains bug fixes and features.

Multiple connections per external secrets provider

You can now set up more than one connection for a single external secrets provider. The updated UI makes it easier to configure and manage multiple connections under the same provider type.

Performance improvements for large workflow and credential volumes

Improved the reliability of the workflows and credentials listing pages for large-scale instances, reducing loading times by 30% to 80%.

Contributors

peteawood
horiyee

For full release details, refer to Releases on GitHub.

n8n@2.9.4

View the commits for this version.
Release date: 2026-02-25

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.9.3-exp.0

View the commits for this version.
Release date: 2026-02-25

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.9.3

View the commits for this version.
Release date: 2026-02-25

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.9.2

View the commits for this version.
Release date: 2026-02-23

For full release details, refer to Releases on GitHub.

n8n@2.9.1

View the commits for this version.
Release date: 2026-02-18

/// note | Beta version This is the beta version. n8n recommends using the stable version. The beta version may be unstable. To report issues, use the forum. ///

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.8.4

View the commits for this version.

Release date: 2026-02-23

This release contains bug fixes.

n8n@2.8.3

View the commits for this version.
Release date: 2026-02-13

This release contains a bug fix.

/// note | Stable version This is the stable version. n8n recommends using the stable version. The beta version may be unstable. To report issues, use the forum. ///

For full release details, refer to Releases on GitHub.

n8n@2.7.5

View the commits for this version.
Release date: 2026-02-13

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.9.0

View the commits for this version.
Release date: 2026-02-16

This release contains bug fixes and features.

Personal space policies (Enterprise)

A new Security & policies settings section provides a central place for enforcing security requirements on your instance. In addition to the existing two-factor authentication enforcement, admins can now control what users can do in their personal spaces.

Available policies include:

  • Sharing: control whether users can share workflows and credentials from their personal space.
  • Workflow publishing: control whether users can publish workflows from their personal space.

This release builds on the recent updates to the permissions model, including custom project roles, to better support policy-driven governance.

Personal space policies are available on n8n Enterprise.

![Security and policies settings](/_images/release-notes/personal_space_policies.png)
The new Security & policies settings section.

Custom roles: improved discoverability and permission visibility (Enterprise)

The project role selector now separates built-in system roles and custom roles into distinct sections, making it easier to find and choose the right role. Hovering over a role shows a summary of its configured permissions, with an option to view the full permission details.

![Custom roles selector](/_images/release-notes/custom_roles_selector.png)
System roles and custom roles are now displayed in separate sections.

Contributors

ByteEVM
LudwigGerdes

For full release details, refer to Releases on GitHub.

n8n@2.8.2

View the commits for this version.
Release date: 2026-02-12

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.8.1

View the commits for this version.
Release date: 2026-02-11

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.7.4

View the commits for this version.
Release date: 2026-02-11

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.7.3

View the commits for this version.
Release date: 2026-02-09

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.6.4

View the commits for this version.
Release date: 2026-02-06

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.8.0

View the commits for this version.
Release date: 2026-02-09

This release contains bug fixes and features.

Stronger external secrets validation (Enterprise)

n8n now verifies that the current user has access to the referenced vaults before allowing a credential that uses $secrets... expressions to be saved. If access is missing, the save operation fails. This prevents secret values from being exposed through guessed secret paths.

Improved API auditability (Enterprise)

API endpoints have been expanded to provide clearer visibility into project membership and credentials:

  • GET /projects/{projectId}/users returns all members of a project including their assigned role.
  • GET /credentials returns a paginated list of all credentials across the instance, including the project they belong to.

This makes it easier to audit who has access to which projects and credentials without manually reviewing each one in the UI.

More granular workflow permissions

Workflow publishing permissions for custom roles have been split into two separate scopes: workflow:publish and workflow:unpublish. This enables more precise access control in governance scenarios where unpublishing needs to be managed independently.

Performance and stability improvements

  • Improved performance for instances with very large user counts, reducing slowdowns caused by user-related operations.
  • Fixed a high-memory issue that could cause crashes during Source Control push flows in large deployments with many workflows and credentials.

Minor fixes

  • Canvas: improved node repositioning on insertion to reduce overlaps and spacing issues.
  • Log streaming: fixed proxy configuration handling for webhook destinations so requests work reliably when a proxy is configured.

Deprecated nodes


Motorhead node

The Motorhead memory node is now deprecated because the Motorhead project is no longer maintained. The node is hidden from the nodes panel for new selections, but existing workflows using this node will continue to work.

Contributors

AmitAnveri
derandreas-dt
ongdisheng
vCaisim

For full release details, refer to Releases on GitHub.

n8n@2.7.2

View the commits for this version.
Release date: 2026-02-04

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.7.1

View the commits for this version.
Release date: 2026-02-03

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.7.0

View the commits for this version.
Release date: 2026-02-02

This release contains bug fixes.

Contributors

LostInBrittany
adriencohen
ibex088
rutgere-indeed

For full release details, refer to Releases on GitHub.

n8n@2.4.7-exp.0

View the commits for this version.
Release date: 2026-01-29

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.6.3

View the commits for this version.
Release date: 2026-02-02

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.8

View the commits for this version.
Release date: 2026-01-29

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.6.2

View the commits for this version.
Release date: 2026-01-28

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.7

View the commits for this version.
Release date: 2026-01-28

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.5.2

View the commits for this version.
Release date: 2026-01-23

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.6

View the commits for this version.
Release date: 2026-01-23

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.5

View the commits for this version.
Release date: 2026-01-22

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.6.0

View the commits for this version.
Release date: 2026-01-26

This release contains bug fixes.

Human-in-the-loop for AI tool calls

You can now require explicit human approval before an AI Agent executes specific tools.

Human-in-the-loop (HITL) for AI tool calls enforces review directly at the tool level. A gated tool cannot execute unless a human explicitly approves the action, giving you deterministic control over high-impact operations like deleting records, writing to production systems, or sending high-impact emails. This removes the uncertainty of prompt-based safeguards and insulates you from probabilistic agent behavior.

Because the review step is implemented using standard n8n integrations, approvals are not limited to a single user or interface. Decisions can be routed across people and systems, enforcing approval from the right person using the channels they already work in.

What you can do

  • Require explicit human approval for any tool the agent can call, including the MCP Client tool or sub-workflows exposed as tools
  • Apply approval selectively, so some tools execute autonomously while others require review
  • Route approvals across users and channels (for example, send a Slack-initiated action for approval by another user via email)
  • Add safety checks for high-impact or potentially destructive operations without complex workflow patterns or brittle prompt logic.

How to use it

Start with a workflow where an AI Agent is connected to one or more tools.

  1. On the connection from the AI Agent to the tool you want to gate, click the + icon and choose Add human review step (hovering over the icon shows the tooltip).
  2. The Tools panel opens with nodes you can use to handle the review step. Select the one you want to use.
  3. Configure the approval step in the added nodes parameters. Depending on the integration, you can define the approver, the message they receive, the available actions (for example, approve or deny), and the associated buttons.

    Get precise control over where human judgment is required, without limiting what your agent can do. Learn more here.
### Contributors

ibex088
johnlinp
loganaden
Jameswlepage
cesars-gh
antman1p

For full release details, refer to Releases on GitHub.

n8n@2.5.0

View the commits for this version.
Release date: 2026-01-20

This release contains bug fixes.

Chat node: human-in-the-loop actions

The Chat node now includes two new Actions for human-in-the-loop interactions in agentic workflows:

  • Send a message: send a message to the user and continue the workflow
  • Send a message and wait for response: send a message and pause execution until the user replies. Users can respond with free text in the Chat or by clicking inline approval buttons, as defined in the nodes configuration.

These Actions can be used as deterministic workflow steps or as tools for an AI Agent, enabling multi-turn human interaction within a single execution when using the Chat Trigger.

When used as an agent tool, the agent can ask for clarification before proceeding, helping it better interpret user intent and follow instructions. Agents can also send updates during long-running workflows using these Actions.

How to

  1. Trigger your workflow with the Chat Trigger node. In the node parameters, add the Response Mode option and set it to Using Response Nodes.
  2. Add a Chat node later in the workflow, or add it as a tool for an AI Agent. Select one of the following operations: Send a message or Send a message and wait for response.

Keep in mind

  • If you want an AI Agent to choose between sending a message or waiting for input, add two Chat tool nodes, one for each action.
  • For AI Agents triggered by the Chat Trigger node, adding Send a message and wait for response is recommended so the agent can request clarification when needed.

Learn more in the Chat node documentation.





### Contributors

AbdulTawabJuly
ByteEVM
sudarshan12s
KaanAydinli

For full release details, refer to Releases on GitHub.

n8n@2.4.3

View the commits for this version.
Release date: 2026-01-15

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.3.6

View the commits for this version.
Release date: 2026-01-16

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.4

View the commits for this version.
Release date: 2026-01-16

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.3.5

View the commits for this version.
Release date: 2026-01-14

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.4.1

View the commits for this version.
Release date: 2026-01-13

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.3.2

View the commits for this version.
Release date: 2026-01-09

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.4.0

View the commits for this version.
Release date: 2026-01-12

This release contains bug fixes.

TLS support for Syslog log streaming

The Syslog log streaming destination now supports TLS over TCP for encrypted connections. This enables secure log streaming to enterprise SIEM and observability platforms that require encrypted transport. With this release, log streaming is now compatible with a broader range of enterprise SIEM platforms.

Update credentials via API

n8n's public API now supports updating existing credentials by ID via a new PATCH /credentials/:id endpoint. Previously, credentials could only be created through the API so any changes required deleting and recreating the credential.

When updating, you can either replace all credential data at once (useful for bulk updates) or set isPartialData: true to merge changes with existing data. Ideal for automated secret rotation or fixing individual values without losing your configuration.

### Contributors

JonLaliberte
davidpanic
TomTom101
garritfra
maximepvrt

For full release details, refer to Releases on GitHub.

n8n@2.3.3

View the commits for this version.
Release date: 2026-01-13

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.3.4

View the commits for this version.
Release date: 2026-01-13

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.3.1

View the commits for this version.
Release date: 2026-01-07

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.2.5

View the commits for this version.
Release date: 2026-01-08

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.2.4

View the commits for this version.
Release date: 2026-01-06

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.3.0

View the commits for this version.
Release date: 2026-01-05

This release contains bug fixes.

Contributors

Shashwat-06
ByteEVM
mithredate
belyas
saurabhssonkar

For full release details, refer to Releases on GitHub.

n8n@2.2.3

View the commits for this version.
Release date: 2026-01-05

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.2.2

View the commits for this version.
Release date: 2025-12-30

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.1.5

View the commits for this version.
Release date: 2025-12-30

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.1.4

View the commits for this version.
Release date: 2025-12-23

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.1.3

View the commits for this version.
Release date: 2025-12-23

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.2.1

View the commits for this version.
Release date: 2025-12-23

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.2.0

View the commits for this version.

Release date: 2025-12-22

This release contains bug fixes.

More granular workflow permissions within Custom Project Roles (Enterprise)

Custom Project Roles allow you to define fine-grained permissions at the project level. With this release, workflow permissions have been further refined by separating workflow editing from workflow publishing.

This change makes it easier to align access controls with internal processes where building workflows and publishing them are handled by different users or teams.

![Custom Project Roles](/_images/release-notes/WorkflowEditor.png)
Custom Project Roles

Log streaming: More audit events for improved observability

Log streaming now includes additional audit events to improve visibility into operational and security-relevant changes.

This update adds events for manual workflow cancellations and workflow activation/deactivation (publish/unpublish), variable lifecycle events (create/update/delete), and user management actions (including enabling/disabling 2FA).

Workflow settings updates are also logged with the specific parameters that changed (for example, selecting a new error workflow), instead of a generic “updated” event.

For full release details, refer to Releases on GitHub.

n8n@2.1.2

View the commits for this version.
Release date: 2025-12-22

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.1.1

View the commits for this version.
Release date: 2025-12-17

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.0.3

View the commits for this version.
Release date: 2025-12-17

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.1.0

View the commits for this version.
Release date: 2025-12-16

This release contains bug fixes and features.

Time Saved node

Previously, teams could only track a single fixed time saved value for each workflow regardless of which path an execution takes. The new Time Saved node enables more precise time savings calculations where different execution paths will save different amounts of time.

With this release you can now:

  • Choose fixed value or dynamic time tracking: Use fixed time saved for simple workflows, or use one or many time saved nodes to calculate savings dynamically based on the actual execution path taken
  • Configure per-item calculations: When using the Time Saved node, choose whether to calculate time saved once for all items or multiply by the number of items processed

The new Time Saved node provides increased accuracy for complex workflows where different execution paths save different amounts of time.

time saved node example

n8n automatically totals the time from all Time Saved nodes executed during each workflow run and reports it within the insights dashboard.

insights dashboard

Contributors

Akcthecoder200
rishiraj-58
rlafferty

For full release details, refer to Releases on GitHub.

n8n@2.0.2

View the commits for this version.
Release date: 2025-12-12

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.0.1

View the commits for this version.
Release date: 2025-12-10

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.0.0

View the commits for this version.
Release date: 2025-12-05

Major Version Change

n8n 2.0.0 is a hardening release, not a feature release. It strengthens n8n's position as an enterprise-grade platform with secure-by-default execution, removal of legacy options that caused edge-case bugs, and better performance under load. The goal is a more predictable foundation you can rely on for mission-critical workflows.

This release is currently in beta. There's no urgency to upgrade immediately — take time to review the breaking changes and assess your workflows using the migration tool before upgrading.

For the full story behind 2.0, read our announcement blog post.

Breaking changes

Version 2.0 includes breaking changes across security defaults, data handling, and configuration. Key changes include:

  • Task runners enabled by default (Code node executions now run in isolated environments)
  • Environment variable access blocked from Code nodes by default
  • ExecuteCommand and LocalFileTrigger nodes disabled by default
  • In-memory binary data mode removed

Review the complete list and migration guidance in the v2.0 breaking changes docs.

Before you upgrade

Use the Migration Report tool to identify workflow-level and instance-level issues that need attention before upgrading.

See the v2.0 migration tool docs for details.

Product updates

Publish / Save workflow paradigm

n8n 2.0 introduces a safer approach to updating live workflows. The Save button now preserves your edits without changing production. A new Publish button lets you explicitly push changes live when ready. See Publish workflows for details.

Canvas and navigation improvements

Subtle refinements to the workflow editor canvas and reorganized sidebar navigation.

For full release details, refer to Releases on GitHub.

n8n@2.0.0-rc.4

View the commits for this version.
Release date: 2025-12-05

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.0.0-rc.3

View the commits for this version.
Release date: 2025-12-04

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.0.0-rc.2

View the commits for this version.
Release date: 2025-12-04

This release contains a bug fix.

For full release details, refer to Releases on GitHub.

n8n@2.0.0-rc.1

View the commits for this version.
Release date: 2025-12-04

This release contains bug fixes.

For full release details, refer to Releases on GitHub.

n8n@2.0.0-rc.0

View the commits for this version.
Release date: 2025-12-02

This release contains bug fixes.

Contributors

farzad528

For full release details, refer to Releases on GitHub.

/// note | Older versions You can find the release notes for older versions of n8n: 1.x and 0.x ///