Skip to content

Release notes#

New features and bug fixes for n8n.

You can also view the Releases in the GitHub repository.

Stable and Beta versions

n8n releases a new minor version most weeks. The stable version is for production use. beta is the most recent release. The beta version may be unstable. To report issues, use the forum.

Current stable: 2.9.4 Current beta: 2.10.2

How to update n8n#

The steps to update your n8n depend on which n8n platform you use. Refer to the documentation for your n8n:

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.

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

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.

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
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
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 node’s 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 node’s 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
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.

Older versions

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

This page was