From df81ee805928aea9bf657c1a138dcf7d5d9e0338 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sun, 30 Nov 2025 08:50:41 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 12 + README.md | 3 + plugin.lock.json | 64 + skills/n8n/SKILL.md | 370 + skills/n8n/plugin.json | 15 + skills/n8n/references/index.md | 7 + skills/n8n/references/llms-full.md | 84909 +++++++++++++++++++++++++++ skills/n8n/references/llms-txt.md | 81750 ++++++++++++++++++++++++++ skills/n8n/references/llms.md | 1243 + 9 files changed, 168373 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 plugin.lock.json create mode 100644 skills/n8n/SKILL.md create mode 100644 skills/n8n/plugin.json create mode 100644 skills/n8n/references/index.md create mode 100644 skills/n8n/references/llms-full.md create mode 100644 skills/n8n/references/llms-txt.md create mode 100644 skills/n8n/references/llms.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..5223416 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "n8n", + "description": "Interacts with the n8n API.", + "version": "0.0.0-2025.11.28", + "author": { + "name": "Tim Green", + "email": "rawveg@gmail.com" + }, + "skills": [ + "./skills/n8n" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..445a84a --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# n8n + +Interacts with the n8n API. diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..37c6557 --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,64 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:rawveg/skillsforge-marketplace:n8n", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "a6640635a8a05345eb07ae40a546dd6599ea81ed", + "treeHash": "05d41757faf40759698f87e54b6a6c3f7a195feb069c69273c26fcca6f48db55", + "generatedAt": "2025-11-28T10:27:52.776205Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "n8n", + "description": "Interacts with the n8n API." + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "033bbfde2d8315307dddc28d31321d28b5c4daa0adc7cc9ac6631d195835a760" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "89f2b1c6826007654fa8f09f2e2b49495a26f641284da9c35d749df73745b365" + }, + { + "path": "skills/n8n/plugin.json", + "sha256": "a59a36b0d945c9f4bf27add5f2ba8896af10e44270e228340633d962de137a53" + }, + { + "path": "skills/n8n/SKILL.md", + "sha256": "b9821b5aa1d49836f5efd810b520816909df8e764bb406d8cf733a1a11e55bd1" + }, + { + "path": "skills/n8n/references/llms.md", + "sha256": "f1c8a05590ec23b205b0e479bb22066c8c824e0c9f9776b207807c0ffa8efb37" + }, + { + "path": "skills/n8n/references/llms-txt.md", + "sha256": "ac6759f70f0997946c411686ea93aae646cc6b66cbc1947db4dca6a5bc1f1c25" + }, + { + "path": "skills/n8n/references/index.md", + "sha256": "efac5f5394f9c552852302bd0bf047fb0c2f5a3e8eaf7d48a155340b3a64d47e" + }, + { + "path": "skills/n8n/references/llms-full.md", + "sha256": "35ae51508f7619926ad6f593fd3c4c44216c39e629bbadbe6e4b3ff85be5f2eb" + } + ], + "dirSha256": "05d41757faf40759698f87e54b6a6c3f7a195feb069c69273c26fcca6f48db55" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/n8n/SKILL.md b/skills/n8n/SKILL.md new file mode 100644 index 0000000..c770a94 --- /dev/null +++ b/skills/n8n/SKILL.md @@ -0,0 +1,370 @@ +--- +name: n8n +description: N8N Documentation - Workflow automation platform with AI capabilities +--- + +# N8N Skill + +Comprehensive assistance with n8n development, generated from official documentation. n8n is a fair-code licensed workflow automation tool that combines AI capabilities with business process automation. + +## When to Use This Skill + +This skill should be triggered when: +- Building or debugging n8n workflows +- Working with the Code node (JavaScript or Python) +- Using expressions and data transformations +- Implementing AI agents, chains, or RAG workflows +- Configuring n8n deployments (Docker, npm, self-hosted) +- Setting up webhooks, credentials, or integrations +- Handling errors in workflows +- Scaling n8n with queue mode +- Creating custom nodes or white labeling n8n +- Using the n8n API programmatically +- Working with LangChain in n8n +- Migrating to n8n v1.0 + +## Key Concepts + +### Core Components +- **Workflows**: Visual automation flows with nodes connected together +- **Nodes**: Individual operations in a workflow (trigger, action, logic, etc.) +- **Expressions**: Code snippets using `{{ }}` syntax to access and transform data +- **Credentials**: Secure storage for API keys and authentication +- **Executions**: Individual workflow runs with their data and status + +### Data Structure +- n8n passes data between nodes as **items** (array of JSON objects) +- Each item has a `json` property containing the main data +- Binary data is stored separately in the `binary` property +- Use `$json` to access current item's data in expressions + +### AI Capabilities +- **Agents**: AI that can use tools and make decisions +- **Chains**: Predefined sequences of AI operations +- **Memory**: Store conversation history for context +- **Tools**: Functions that AI agents can call +- **Vector Databases**: Store and retrieve embeddings for RAG + +## Quick Reference + +### Example 1: Basic Expression to Access Data +```javascript +// Access data from the current item +{{ $json.name }} + +// Access data from a specific node +{{ $node["HTTP Request"].json.response }} + +// Access all items from a node +{{ $("HTTP Request").all() }} +``` + +### Example 2: HTTP Request with Authentication +When working with the HTTP Request node, handle errors and rate limits: + +```javascript +// In HTTP Request node settings: +// - Enable "Retry on Fail" +// - Set Max Tries to 3 +// - Set Wait Between Tries (ms) to 1000 + +// For rate limiting, use Batching: +// - Items per Batch: 10 +// - Batch Interval (ms): 1000 +``` + +### Example 3: Code Node - Transform Data (JavaScript) +```javascript +// Access input data +const items = $input.all(); + +// Transform each item +return items.map(item => { + return { + json: { + fullName: `${item.json.firstName} ${item.json.lastName}`, + email: item.json.email.toLowerCase(), + timestamp: new Date().toISOString() + } + }; +}); +``` + +### Example 4: Code Node - Filter Data (Python) +```python +# Filter items based on a condition +output = [] + +for item in items: + if item['json']['status'] == 'active': + output.append({ + 'json': { + 'id': item['json']['id'], + 'name': item['json']['name'] + } + }) + +return output +``` + +### Example 5: Expression - Date Handling with Luxon +```javascript +// Current date +{{ $now }} + +// Format date +{{ $now.toFormat('yyyy-MM-dd') }} + +// Add 7 days +{{ $now.plus({ days: 7 }) }} + +// Parse and format custom date +{{ DateTime.fromISO($json.dateString).toFormat('LLL dd, yyyy') }} +``` + +### Example 6: JWT Authentication Credential +For APIs requiring JWT authentication: + +```javascript +// Use JWT credential with: +// - Key Type: Passphrase (for HMAC) or PEM Key (for RSA/ECDSA) +// - Secret: Your secret key +// - Algorithm: HS256, RS256, ES256, etc. + +// The JWT credential automatically generates tokens +// Use it in HTTP Request node > Authentication > JWT +``` + +### Example 7: Handle Errors in Workflow +```javascript +// In Code node, use try-catch: +try { + const result = $json.data.someField.toUpperCase(); + return [{ json: { result } }]; +} catch (error) { + // Return error information + return [{ + json: { + error: error.message, + originalData: $json + } + }]; +} + +// Or set up Error Workflow in Workflow Settings +// to catch all failures and send notifications +``` + +### Example 8: Pagination in HTTP Request +```javascript +// Use pagination to fetch all pages +// In HTTP Request node > Pagination: + +// Type: Generic Pagination +// Request URL: {{ $url }}&page={{ $pageNumber }} +// Complete When: {{ $response.body.hasMore === false }} +// Next Page URL: Automatic +``` + +### Example 9: AI Agent with Tools +```javascript +// In AI Agent node: +// 1. Connect a Chat Model (OpenAI, etc.) +// 2. Add tools (Calculator, HTTP Request, etc.) +// 3. Configure memory if needed + +// The agent can: +// - Analyze user input +// - Decide which tools to use +// - Execute tools and process results +// - Return final answer +``` + +### Example 10: Environment Variables and Static Data +```javascript +// Access environment variables +{{ $env.MY_API_KEY }} + +// Store workflow static data (persists across executions) +const staticData = getWorkflowStaticData('global'); +staticData.lastRun = new Date().toISOString(); +staticData.counter = (staticData.counter || 0) + 1; + +// Retrieve static data +{{ $workflow.staticData.counter }} +``` + +## Reference Files + +This skill includes comprehensive documentation in `references/`: + +- **llms-txt.md** - Complete n8n documentation formatted for LLMs + - Installation and setup guides + - Node reference documentation + - API documentation + - Code examples and patterns + - Configuration options + - Troubleshooting guides + +- **llms-full.md** - Extended documentation with deep technical details + - Advanced configuration + - Scaling and performance + - Security and authentication + - Custom node development + - White labeling and embed options + +Use `view` to read specific reference files when detailed information is needed. + +## Working with This Skill + +### For Beginners +1. Start with basic workflow creation: + - Trigger nodes (Webhook, Schedule, Manual) + - Action nodes (HTTP Request, Set, Edit Fields) + - Learn expression syntax with simple `{{ $json.field }}` access + +2. Understand data structure: + - Each node outputs an array of items + - Use the data inspector to see item structure + - Practice with the Edit Fields node for data transformation + +3. Common patterns: + - Webhook → HTTP Request → Set → Respond to Webhook + - Schedule → Code → HTTP Request → Conditional + - Manual → Loop Over Items → Process Each + +### For Intermediate Users +1. Master the Code node: + - JavaScript mode for complex transformations + - Access `$input.all()` for all items + - Return properly formatted items with `json` property + +2. Work with expressions: + - Use built-in methods: `.first()`, `.last()`, `.item` + - Date manipulation with Luxon + - JMESPath for complex JSON queries + +3. Error handling: + - Use Try-Catch in Code nodes + - Set up Error Workflows + - Configure Retry on Fail for API calls + +4. Data operations: + - Merge data from multiple sources + - Split and filter items + - Loop over items for batch processing + +### For Advanced Users +1. AI and LangChain: + - Build AI agents with custom tools + - Implement RAG with vector databases + - Use memory for conversational workflows + - Chain multiple AI operations + +2. Scaling and performance: + - Configure queue mode for distributed execution + - Optimize database settings + - Use execution data pruning + - Configure task runners + +3. Custom development: + - Create custom nodes + - White label n8n for embedding + - Use the n8n API for workflow management + - Implement external secrets with AWS/Azure/GCP + +4. Advanced patterns: + - Sub-workflows for reusability + - Webhook authentication and validation + - Complex data transformations with JMESPath + - Real-time data processing with SSE/WebSockets + +## Common Issues and Solutions + +### HTTP Request Errors +- **400 Bad Request**: Check query parameters and array formatting +- **403 Forbidden**: Verify credentials and API permissions +- **429 Rate Limit**: Use Batching or Retry on Fail options +- **404 Not Found**: Verify endpoint URL is correct + +### Expression Errors +- Workflows now fail on expression errors in v1.0+ +- Set up Error Workflows to catch failures +- Test expressions in the expression editor +- Check for undefined values before accessing properties + +### Data Type Issues +- Use `.toString()`, `.toNumber()` for type conversion +- Handle null/undefined with `{{ $json.field || 'default' }}` +- Binary data requires special handling with buffers + +### Migration to v1.0 +- New execution order (depth-first instead of breadth-first) +- Python support in Code node (Pyodide) +- Mandatory user management (no more BasicAuth) +- WebSocket push backend is now default +- Node 18.17.0 or higher required + +## Environment Configuration + +### Docker Setup +```bash +# Basic n8n with Docker +docker run -it --rm \ + --name n8n \ + -p 5678:5678 \ + -v ~/.n8n:/home/node/.n8n \ + n8nio/n8n + +# With environment variables +docker run -it --rm \ + --name n8n \ + -p 5678:5678 \ + -e N8N_BASIC_AUTH_ACTIVE=true \ + -e N8N_BASIC_AUTH_USER=admin \ + -e N8N_BASIC_AUTH_PASSWORD=password \ + -v ~/.n8n:/home/node/.n8n \ + n8nio/n8n +``` + +### Key Environment Variables +- `N8N_HOST`: Hostname (default: localhost) +- `N8N_PORT`: Port (default: 5678) +- `N8N_PROTOCOL`: http or https +- `WEBHOOK_URL`: External webhook URL +- `N8N_ENCRYPTION_KEY`: Encryption key for credentials +- `DB_TYPE`: Database type (sqlite, postgres) +- `EXECUTIONS_MODE`: queue or main (queue for scaling) + +## Resources + +### Official Resources +- [n8n Documentation](https://docs.n8n.io/) +- [n8n Community Forum](https://community.n8n.io/) +- [n8n Workflow Templates](https://n8n.io/workflows/) +- [n8n GitHub Repository](https://github.com/n8n-io/n8n) + +### Learning Paths +- Level One Course: Basic workflow building +- Level Two Course: Advanced data handling and error management +- Video Courses: Visual learning resources +- AI Tutorial: Build AI workflows from scratch + +### API and Development +- [API Reference](https://docs.n8n.io/api/api-reference/) +- [Creating Custom Nodes](https://docs.n8n.io/integrations/creating-nodes/) +- [Node Development](https://docs.n8n.io/integrations/creating-nodes/build/) + +## Notes + +- This skill was automatically generated from official n8n documentation +- Code examples use proper language tags for syntax highlighting +- Examples are extracted from real-world patterns in the docs +- Focus on practical, actionable patterns for immediate use + +## Updating + +To refresh this skill with updated documentation: +1. Re-run the scraper with the same configuration +2. The skill will be rebuilt with the latest information +3. Review Quick Reference section for new examples diff --git a/skills/n8n/plugin.json b/skills/n8n/plugin.json new file mode 100644 index 0000000..00a785b --- /dev/null +++ b/skills/n8n/plugin.json @@ -0,0 +1,15 @@ +{ + "name": "n8n", + "description": "A skill for working with n8n", + "version": "1.0.0", + "author": { + "name": "Tim Green", + "email": "rawveg@gmail.com" + }, + "homepage": "https://github.com/rawveg/claude-skills-marketplace", + "repository": "https://github.com/rawveg/claude-skills-marketplace", + "license": "MIT", + "keywords": ["n8n", "n8n skill", "n8n skills", "Claude Skills", "Claude Skills Marketplace"], + "category": "productivity", + "strict": false +} diff --git a/skills/n8n/references/index.md b/skills/n8n/references/index.md new file mode 100644 index 0000000..48c48e2 --- /dev/null +++ b/skills/n8n/references/index.md @@ -0,0 +1,7 @@ +# N8N Documentation Index + +## Categories + +### Llms-Txt +**File:** `llms-txt.md` +**Pages:** 1301 diff --git a/skills/n8n/references/llms-full.md b/skills/n8n/references/llms-full.md new file mode 100644 index 0000000..c66e13f --- /dev/null +++ b/skills/n8n/references/llms-full.md @@ -0,0 +1,84909 @@ +# n8n Docs + +> Documentation for n8n, a workflow automation platform. + +Documentation for n8n, a workflow automation platform. This file helps LLMs understand and use the documentation more effectively. + + +# All documentation + +# Welcome to n8n Docs + +This is the documentation for [n8n](https://n8n.io/), a [fair-code](https://faircode.io) licensed workflow automation tool that combines AI capabilities with business process automation. + +It covers everything from setup to usage and development. It's a work in progress and all [contributions](help-community/contributing/) are welcome. + +## Where to start + +- **Quickstarts** + + Jump in with n8n's quickstart guides. + + [Try it out](try-it-out/) + +- **Choose the right n8n for you** + + Cloud, npm, self-host . . . + + [Options](choose-n8n/) + +- **Explore integrations** + + Browse n8n's integrations library. + + [Find your apps](integrations/) + +- **Build AI functionality** + + n8n supports building AI functionality and tools. + + [Advanced AI](advanced-ai/) + +## About n8n + +n8n (pronounced n-eight-n) helps you to connect any app with an API with any other, and manipulate its data with little or no code. + +- Customizable: highly flexible workflows and the option to build custom nodes. +- Convenient: use the npm or Docker to try out n8n, or the Cloud hosting option if you want us to handle the infrastructure. +- Privacy-focused: self-host n8n for privacy and security. + +# n8n v1.0 migration guide + +This document provides a summary of what you should be aware of before updating to version 1.0 of n8n. + +The release of n8n 1.0 marks a milestone in n8n's journey to make n8n available for demanding production environments. Version 1.0 represents the hard work invested over the last four years to make n8n the most accessible, powerful, and versatile automation tool. n8n 1.0 is now ready for use in production. + +## New features + +### Python support in the Code node + +Although JavaScript remains the default language, you can now also select Python as an option in the [Code node](../code/code-node/) and even make use of [many Python modules](https://pyodide.org/en/stable/usage/packages-in-pyodide.html#packages-in-pyodide). Note that Python is unavailable in Code nodes added to a workflow before v1.0. + +[PR #4295](https://github.com/n8n-io/n8n/pull/4295), [PR #6209](https://github.com/n8n-io/n8n/pull/6209) + +### Execution order + +n8n 1.0 introduces a new execution order for multi-branch workflows: + +In multi-branch workflows, n8n needs to determine the order in which to execute nodes on branches. Previously, n8n executed the first node of each branch, then the second of each branch, and so on (breadth-first). The new execution order ensures that each branch executes completely before starting the next one (depth-first). Branches execute based on their position on the canvas, from top to bottom. If two branches are at the same height, the leftmost one executes first. + +n8n used to execute multi-input nodes as long as they received data on their first input. Nodes connected to the second input of multi-input nodes automatically executed regardless of whether they received data. The new execution order introduced in n8n 1.0 simplifies this behavior: Nodes are now executed only when they receive data, and multi-input nodes require data on at least one of their inputs to execute. + +Your existing workflows will use the legacy order, while new workflows will execute using the v1 order. You can configure the execution order for each workflow in [workflow settings](../workflows/settings/). + +[PR #4238](https://github.com/n8n-io/n8n/pull/4238), [PR #6246](https://github.com/n8n-io/n8n/pull/6246), [PR #6507](https://github.com/n8n-io/n8n/pull/6507) + +## Deprecations + +### MySQL and MariaDB + +n8n has deprecated support for MySQL and MariaDB as storage backends for n8n. These database systems are used by only a few users, yet they require continuous development and maintenance efforts. n8n recommends migrating to PostgreSQL for better compatibility and long-term support. + +[PR #6189](https://github.com/n8n-io/n8n/pull/6189) + +### EXECUTIONS_PROCESS and "own" mode + +Previously, you could use the `EXECUTIONS_PROCESS` environment variable to specify whether executions should run in the `main` process or in their `own` processes. This option and `own` mode are now deprecated and will be removed in a future version of n8n. This is because it led to increased code complexity while offering marginal benefits. Starting from n8n 1.0, `main` will be the new default. + +Note that executions start much faster in `main` mode than in `own` mode. However, if a workflow consumes more memory than is available, it might crash the entire n8n application instead of just the worker thread. To mitigate this, make sure to allocate enough system resources or configure [queue mode](../hosting/scaling/queue-mode/) to distribute executions among multiple workers. + +[PR #6196](https://github.com/n8n-io/n8n/pull/6196) + +## Breaking changes + +### Docker + +#### Permissions change + +When using Docker-based deployments, the n8n process is now run by the user `node` instead of `root`. This change increases security. + +If permission errors appear in your n8n container logs when starting n8n, you may need to update the permissions by executing the following command on the Docker host: + +``` +docker run --rm -it --user root -v ~/.n8n:/home/node/.n8n --entrypoint chown n8nio/base:16 -R node:node /home/node/.n8n +``` + +#### Image removal + +We've removed the Debian and RHEL images. If you were using these you need to change the image you use. This shouldn't result in any errors unless you were making a custom image based on one of those images. + +#### Entrypoint change + +The entrypoint for the container has changed and you no longer need to specify the n8n command. If you were previously running `n8n worker --concurrency=5` it's now `worker --concurrency=5` + +[PR #6365](https://github.com/n8n-io/n8n/pull/6365) + +### Workflow failures due to expression errors + +Workflow executions may fail due to syntax or runtime errors in expressions, such as those that reference non-existent nodes. While expressions already throw errors on the frontend, this change ensures that n8n also throws errors on the backend, where they were previously silently ignored. To receive notifications of failing workflows, n8n recommends setting up an "error workflow" under workflow settings. + +[PR #6352](https://github.com/n8n-io/n8n/pull/6352) + +### Mandatory owner account + +This change makes [User Management](../user-management/) mandatory and removes support for other authentication methods, such as BasicAuth and External JWT. Note that the number of permitted users on [n8n.cloud](https://n8n.cloud/) or custom plans still varies depending on your subscription. + +[PR #6362](https://github.com/n8n-io/n8n/pull/6362) + +### Directory for installing custom nodes + +n8n will no longer load custom nodes from its global `node_modules` directory. Instead, you must install (or link) them to `~/.n8n/custom` (or a directory defined by `N8N_CUSTOM_EXTENSIONS`). Custom nodes that are npm packages will be located in `~/.n8n/nodes`. If you have custom nodes that were linked using `npm link` into the global `node_modules` directory, you need to link them again, into `~/.n8n/nodes` instead. + +[PR #6396](https://github.com/n8n-io/n8n/pull/6396) + +### WebSockets + +The `N8N_PUSH_BACKEND` environment variable can be used to configure one of two available methods for pushing updates to the user interface: `sse` and `websocket`. Starting with n8n 1.0, `websocket` is the default method. + +[PR #6196](https://github.com/n8n-io/n8n/pull/6196) + +### Date transformation functions + +n8n provides various transformation functions that operate on dates. These functions may return either a JavaScript `Date` or a Luxon `DateTime` object. With the new behavior, the return type always matches the input. If you call a date transformation function on a `Date`, it returns a `Date`. Similarly, if you call it on a `DateTime` object, it returns a `DateTime` object. + +To identify any workflows and nodes that might be impacted by this change, you can use this [utility workflow](https://n8n.io/workflows/1929-v1-helper-find-params-with-affected-expressions/). + +For more information about date transformation functions, please refer to the [official documentation](../code/builtin/data-transformation-functions/dates/). + +[PR #6435](https://github.com/n8n-io/n8n/pull/6435) + +### Execution data retention + +Starting from n8n 1.0, all successful, failed, and manual workflow executions will be saved by default. These settings can be modified for each workflow under "Workflow Settings," or globally using the respective environment variables. Additionally, the `EXECUTIONS_DATA_PRUNE` setting will be enabled by default, with `EXECUTIONS_DATA_PRUNE_MAX_COUNT` set to 10,000. These default settings are designed to prevent performance degradation when using SQLite. Make sure to configure them according to your individual requirements and system capacity. + +[PR #6577](https://github.com/n8n-io/n8n/pull/6577) + +### Removed N8N_USE_DEPRECATED_REQUEST_LIB + +The legacy `request` library has been deprecated for some time now. As of n8n 1.0, the ability to fall back to it in the HTTP Request node by setting the `N8N_USE_DEPRECATED_REQUEST_LIB` environment variable has been fully removed. The HTTP Request node will now always use the new `HttpRequest` interface. + +If you build custom nodes, refer to [HTTP request helpers](../integrations/creating-nodes/build/reference/http-helpers/) for more information on migrating to the new interface. + +[PR #6413](https://github.com/n8n-io/n8n/pull/6413) + +### Removed WEBHOOK_TUNNEL_URL + +As of version 0.227.0, n8n has renamed the `WEBHOOK_TUNNEL_URL` configuration option to `WEBHOOK_URL`. In n8n 1.0, `WEBHOOK_TUNNEL_URL` has been removed. Update your setup to reflect the new name. For more information about this configuration option, refer to [the docs](../hosting/configuration/configuration-examples/webhook-url/). + +[PR #1408](https://github.com/n8n-io/n8n/pull/1408) + +### Remove Node 16 support + +n8n now requires Node 18.17.0 or above. + +## Updating to n8n 1.0 + +1. Create a full backup of n8n. +1. n8n recommends updating to the latest n8n 0.x release before updating to n8n 1.x. This will allow you to pinpoint any potential issues to the correct release. Once you have verified that n8n 0.x starts up without any issues, proceed to the next step. +1. Carefully read the [Deprecations](#deprecations) and [Breaking Changes](#breaking-changes) sections above to assess how they may affect your setup. +1. Update to n8n 1.0: + - During beta (before July 24th 2023): If using Docker, pull the `next` Docker image. + - After July 24th 2023: If using Docker, pull the `latest` Docker image. +1. If you encounter any issues, redeploy the previous n8n version and restore the backup. + +## Reporting issues + +If you encounter any issues during the process of updating to n8n 1.0, please seek help in the community [forum](https://community.n8n.io/). + +## Thank you + +We would like to take a moment to express our gratitude to all of our users for their continued support and feedback. Your contributions are invaluable in helping us make n8n the best possible automation tool. We're excited to continue working with you as we move forward with the release of version 1.0 and beyond. Thank you for being a part of our journey! + +# Choose your n8n + +This section contains information on n8n's range of platforms, pricing plans, and licenses. + +## Platforms + +There are different ways to set up n8n depending on how you intend to use it: + +- [n8n Cloud](../manage-cloud/overview/): hosted solution, no need to install anything. +- [Self-host](../hosting/): recommended method for production or customized use cases. + - [npm](../hosting/installation/npm/) + - [Docker](../hosting/installation/docker/) + - [Server setup guides](../hosting/installation/server-setups/) for popular platforms +- [Embed](../embed/): n8n Embed allows you to white label n8n and build it into your own product. Contact n8n on the [Embed website](https://n8n.io/embed/) for pricing and support. + +Self-hosting knowledge prerequisites + +Self-hosting n8n requires technical knowledge, including: + +- Setting up and configuring servers and containers +- Managing application resources and scaling +- Securing servers and applications +- Configuring n8n + +n8n recommends self-hosting for expert users. Mistakes can lead to data loss, security issues, and downtime. If you aren't experienced at managing servers, n8n recommends [n8n Cloud](https://n8n.io/cloud/). + +## Licenses + +n8n's [Sustainable Use License](https://github.com/n8n-io/n8n/blob/master/LICENSE.md) and [n8n Enterprise License](https://github.com/n8n-io/n8n/blob/master/LICENSE_EE.md) are based on the [fair-code](https://faircode.io/) model. + +For a detailed explanation of the license, refer to [Sustainable Use License](../sustainable-use-license/). + +## Free versions + +n8n offers the following free options: + +- A free trial of Cloud +- A free self-hosted community edition for self-hosted users + +## Paid versions + +n8n has two paid versions: + +- n8n Cloud: choose from a range of paid plans to suit your usage and feature needs. +- Self-hosted: there are both free and paid versions of self-hosted. + +For details of the Cloud plans and contact details for Enterprise Self-hosted, refer to [Pricing](https://n8n.io/pricing/) on the n8n website. + +# External secrets + +Feature availability + +- External secrets are available on Enterprise Self-hosted and Enterprise Cloud plans. +- n8n supports AWS Secrets Manager, Azure Key Vault, GCP Secrets Manager, Infisical and HashiCorp Vault. +- n8n doesn't support [HashiCorp Vault Secrets](https://developer.hashicorp.com/hcp/docs/vault-secrets). + +You can use an external secrets store to manage [credentials](../glossary/#credential-n8n) for n8n. + +n8n stores all credentials encrypted in its database, and restricts access to them by default. With the external secrets feature, you can store sensitive credential information in an external vault, and have n8n load it in when required. This provides an extra layer of security and allows you to manage credentials used across multiple [n8n environments](../source-control-environments/) in one central place. + +## Connect n8n to your secrets store + +Secret names + +Your secret names can't contain spaces, hyphens, or other special characters. n8n supports secret names containing alphanumeric characters (`a-z`, `A-Z`, and `0-9`), and underscores. n8n currently only supports plaintext values for secrets, not JSON objects or key-value pairs. + +1. In n8n, go to **Settings** > **External Secrets**. + +1. Select **Set Up** for your store provider. + +1. Enter the credentials for your provider: + + - Azure Key Vault: Provide your **vault name**, **tenant ID**, **client ID**, and **client secret**. Refer to the Azure documentation to [register a Microsoft Entra ID app and create a service principal](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal). n8n supports only single-line values for secrets. + + - AWS Secrets Manager: provide your **access key ID**, **secret access key**, and **region**. The IAM user must have the `secretsmanager:ListSecrets`, `secretsmanager:BatchGetSecretValue`, and `secretsmanager:GetSecretValue` permissions. + + To give n8n access to all secrets in your AWS Secrets Manager, you can attach the following policy to the IAM user: + + ``` + { + "Version": "2012-10-17", + "Statement": [ + { + "Sid": "AccessAllSecrets", + "Effect": "Allow", + "Action": [ + "secretsmanager:ListSecrets", + "secretsmanager:BatchGetSecretValue", + "secretsmanager:GetResourcePolicy", + "secretsmanager:GetSecretValue", + "secretsmanager:DescribeSecret", + "secretsmanager:ListSecretVersionIds", + ], + "Resource": "*" + } + ] + } + ``` + + You can also be more restrictive and give n8n access to select specific AWS Secret Manager secrets. You still need to allow the `secretsmanager:ListSecrets` and `secretsmanager:BatchGetSecretValue` permissions to access all resources. These permissions allow n8n to retrieve ARN-scoped secrets, but don't provide access to the secret values. + + Next, you need set the scope for the `secretsmanager:GetSecretValue` permission to the specific Amazon Resource Names (ARNs) for the secrets you wish to share with n8n. Ensure you use the correct region and account ID in each resource ARNs. You can find the ARN details in the AWS dashboard for your secrets. + + For example, the following IAM policy only allows access to secrets with a name starting with `n8n` in your specified AWS account and region: + + ``` + { + "Version": "2012-10-17", + "Statement": [ + { + "Sid": "ListingSecrets", + "Effect": "Allow", + "Action": [ + "secretsmanager:ListSecrets", + "secretsmanager:BatchGetSecretValue" + ], + "Resource": "*" + }, + { + "Sid": "RetrievingSecrets", + "Effect": "Allow", + "Action": [ + "secretsmanager:GetSecretValue", + "secretsmanager:DescribeSecret" + ], + "Resource": [ + "arn:aws:secretsmanager:us-west-2:123456789000:secret:n8n*" + ] + } + ] + } + ``` + + For more IAM permission policy examples, consult the [AWS documentation](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access_iam-policies.html#auth-and-access_examples_batch). + + - HashiCorp Vault: provide the **Vault URL** for your vault instance, and select your **Authentication Method**. Enter your authentication details. Optionally provide a namespace. + + - Refer to the HashiCorp documentation for your authentication method: [Token auth method](https://developer.hashicorp.com/vault/docs/auth/token)\ + [AppRole auth method](https://developer.hashicorp.com/vault/docs/auth/approle)\ + [Userpass auth method](https://developer.hashicorp.com/vault/docs/auth/userpass) + - If you use vault namespaces, you can enter the namespace n8n should connect to. Refer to [Vault Enterprise namespaces](https://developer.hashicorp.com/vault/docs/enterprise/namespaces) for more information on HashiCorp Vault namespaces. + + - Infisical: provide a **Service Token**. Refer to Infisical's [Service token](https://infisical.com/docs/documentation/platform/token) documentation for information on getting your token. If you self-host Infisical, enter the **Site URL**. + + Infisical environment + + Make sure you select the correct Infisical environment when creating your token. n8n will load secrets from this environment, and won't have access to secrets in other Infisical environments. n8n only support service tokens that have access to a single environment. + + Infisical folders + + n8n doesn't support [Infisical folders](https://infisical.com/docs/documentation/platform/folder). + + - Google Cloud Platform: provide a **Service Account Key** (JSON) for a service account that has at least these roles: `Secret Manager Secret Accessor` and `Secret Manager Secret Viewer`. Refer to Google's [service account documentation](https://cloud.google.com/iam/docs/service-account-overview) for more information. + +1. **Save** your configuration. + +1. Enable the provider using the **Disabled / Enabled** toggle. + +## Use secrets in n8n credentials + +To use a secret from your store in an n8n credential: + +1. Create a new credential, or open an existing one. + +1. On the field where you want to use a secret: + + 1. Hover over the field. + 1. Select **Expression**. + +1. In the field where you want to use a secret, enter an [expression](../glossary/#expression-n8n) referencing the secret name: + + ``` + {{ $secrets.. }} + ``` + + `` is either `vault` (for HashiCorp) or `infisical` or `awsSecretsManager`. Replace `` with the name as it appears in your vault. + +## Using external secrets with n8n environments + +n8n's [Source control and environments](../source-control-environments/) feature allows you to create different n8n environments, backed by Git. The feature doesn't support using different credentials in different instances. You can use an external secrets vault to provide different credentials for different environments by connecting each n8n instance to a different vault or project environment. + +For example, you have two n8n instances, one for development and one for production. You use Infisical for your vault. In Infisical, create a project with two environments, development and production. Generate a token for each Infisical environment. Use the token for the development environment to connect your development n8n instance, and the token for your production environment to connect your production n8n instance. + +## Using external secrets in projects + +To use external secrets in an [RBAC project](../user-management/rbac/), you must have an [instance owner or instance admin](../user-management/account-types/) as a member of the project. + +## Troubleshooting + +### Infisical version changes + +Infisical version upgrades can introduce problems connecting to n8n. If your Infisical connection stops working, check if there was a recent version change. If so, report the issue to help@n8n.io. + +### Only set external secrets on credentials owned by an instance owner or admin + +Due to the permissions that instance owners and admins have, it's possible for owners and admins to update credentials owned by another user with a secrets expression. This will appear to work in preview for an instance owner or admin, but the secret won't resolve when the workflow runs in production. + +Only use external secrets for credentials that are owned by an instance admin or owner. This ensures they resolve correctly in production. + +#### AI agent + +AI agents are artificial intelligence systems capable of responding to requests, making decisions, and performing real-world tasks for users. They use large language models (LLMs) to interpret user input and make decisions about how to best process requests using the information and resources they have available. + +#### AI chain + +AI chains allow you to interact with large language models (LLMs) and other resources in sequences of calls to components. AI chains in n8n don't use persistent memory, so you can't use them to reference previous context (use AI agents for this). + +#### AI completion + +Completions are the responses generated by a model like GPT. + +#### AI embedding + +Embeddings are numerical representations of data using vectors. They're used by AI to interpret complex data and relationships by mapping values across many dimensions. Vector databases, or vector stores, are databases designed to store and access embeddings. + +#### AI groundedness + +In AI, and specifically in retrieval-augmented generation (RAG) contexts, groundedness and ungroundedness are measures of how much a model's responses accurately reflect source information. The model uses its source documents to generate grounded responses, while ungrounded responses involve speculation or hallucination unsupported by those same sources. + +#### AI hallucination + +Hallucination in AI is when an LLM (large language model) mistakenly perceives patterns or objects that don't exist. + +#### AI reranking + +Reranking is a technique that refines the order of a list of candidate documents to improve the relevance of search results. Retrieval-Augmented Generation (RAG) and other applications use reranking to prioritize the most relevant information for generation or downstream tasks. + +#### AI memory + +In an AI context, memory allows AI tools to persist message context across interactions. This allows you to have a continuing conversations with AI agents, for example, without submitting ongoing context with each message. In n8n, AI agent nodes can use memory, but AI chains can't. + +#### AI retrieval-augmented generation (RAG) + +Retrieval-augmented generation, or RAG, is a technique for providing LLMs access to new information from external sources to improve AI responses. RAG systems retrieve relevant documents to ground responses in up-to-date, domain-specific, or proprietary knowledge to supplement their original training data. RAG systems often rely on vector stores to manage and search this external data efficiently. + +#### AI tool + +In an AI context, a tool is an add-on resource that the AI can refer to for specific information or functionality when responding to a request. The AI model can use a tool to interact with external systems or complete specific, focused tasks. + +#### AI vector store + +A vector store, or vector database, stores mathematical representations of information. Use with embeddings and retrievers to create a database that your AI can access when answering questions. + +#### API + +APIs, or application programming interfaces, offer programmatic access to a service's data and functionality. APIs make it easier for software to interact with external systems. They're often offered as an alternative to traditional user-focused interfaces accessed through web browsers or UI. + +#### canvas (n8n) + +The canvas is the main interface for building workflows in n8n's editor UI. You use the canvas to add and connect nodes to compose workflows. + +#### cluster node (n8n) + +In n8n, cluster nodes are groups of nodes that work together to provide functionality in a workflow. They consist of a root node and one or more sub nodes that extend the node's functionality. + +#### credential (n8n) + +In n8n, credentials store authentication information to connect with specific apps and services. After creating credentials with your authentication information (username and password, API key, OAuth secrets, etc.), you can use the associated app node to interact with the service. + +#### data pinning (n8n) + +Data pinning allows you to temporarily freeze the output data of a node during workflow development. This allows you to develop workflows with predictable data without making repeated requests to external services. Production workflows ignore pinned data and request new data on each execution. + +#### editor (n8n) + +The n8n editor UI allows you to create and manage workflows. The main area is the canvas, where you can compose workflows by adding, configuring, and connecting nodes. The side and top panels allow you to access other areas of the UI like credentials, templates, variables, executions, and more. + +#### entitlement (n8n) + +In n8n, entitlements grant n8n instances access to plan-restricted features for a specific period of time. + +Floating entitlements are a pool of entitlements that you can distribute among various n8n instances. You can re-assign a floating entitlement to transfer its access to a different n8n instance. + +#### evaluation (n8n) + +In n8n, evaluation allows you to tag and organize execution history and compare it against new executions. You can use this to understand how your workflow performs over time as you make changes. In particular, this is useful while developing AI-centered workflows. + +#### expression (n8n) + +In n8n, expressions allow you to populate node parameters dynamically by executing JavaScript code. Instead of providing a static value, you can use the n8n expression syntax to define the value using data from previous nodes, other workflows, or your n8n environment. + +#### LangChain + +LangChain is an AI-development framework used to work with large language models (LLMs). LangChain provides a standardized system for working with a wide variety of models and other resources and linking different components together to build complex applications. + +#### Large language model (LLM) + +Large language models, or LLMs, are AI machine learning models designed to excel in natural language processing (NLP) tasks. They're built by training on large amounts of data to develop probabilistic models of language and other data. + +#### node (n8n) + +In n8n, nodes are individual components that you compose to create workflows. Nodes define when the workflow should run, allow you to fetch, send, and process data, can define flow control logic, and connect with external services. + +#### project (n8n) + +n8n projects allow you to separate workflows, variables, and credentials into separate groups for easier management. Projects make it easier for teams to collaborate by sharing and compartmentalizing related resources. + +#### root node (n8n) + +Each n8n cluster node contains a single root nodes that defines the main functionality of the cluster. One or more sub nodes attach to the root node to extend its functionality. + +#### sub node (n8n) + +n8n cluster nodes consist of one or more sub nodes connected to a root node. Sub nodes extend the functionality of the root node, providing access to specific services or resources or offering specific types of dedicated processing, like calculator functionality, for example. + +#### template (n8n) + +n8n templates are pre-built workflows designed by n8n and community members that you can import into your n8n instance. When using templates, you may need to fill in credentials and adjust the configuration to suit your needs. + +#### trigger node (n8n) + +A trigger node is a special node responsible for executing the workflow in response to certain conditions. All production workflows need at least one trigger to determine when the workflow should run. + +#### workflow (n8n) + +An n8n workflow is a collection of nodes that automate a process. Workflows begin execution when a trigger condition occurs and execute sequentially to achieve complex tasks. + +# Insights + +Insights gives instance owners and admins visibility into how workflows perform over time. This feature consists of three parts: + +- [**Insights summary banner**](#insights-summary-banner): Shows key metrics about your instance from the last 7 days at the top of the overview space. +- [**Insights dashboard**](#insights-dashboard): A more detailed visual breakdown with per-workflow metrics and historical comparisons. +- [**Time saved (Workflow ROI)**](#setting-the-time-saved-by-a-workflow): For each workflow, you can set the number of minutes of work that each production execution saves you. + +Feature availability + +The insights summary banner displays activity from the last 7 days for all plans. The insights dashboard is only available on Pro (with limited date ranges) and Enterprise plans. + +## Insights summary banner + +n8n collects several metrics for both the insights summary banner and dashboard. They include: + +- Total production executions (not including sub-workflow executions or manual executions) +- Total failed production executions +- Production execution failure rate +- Time saved (when set on at least one or more active workflows) +- Run time average (including wait time from any wait nodes) + +## Insights dashboard + +Those on the Pro and Enterprise plans can access the **Insights** section from the side navigation. Each metric from the summary banner is also clickable, taking you to the corresponding chart. + +The insights dashboard also has a table showing individual insights from each workflow including total production executions, failed production executions, failure rate, time saved, and run time average. + +## Insights time periods + +By default, the insights summary banner and dashboard show a rolling 7 day window with a comparison to the previous period to identify increases or decreases for each metric. On the dashboard, paid plans also display data for other date ranges: + +- Pro: 7 and 14 days +- Enterprise: 24 hours, 7 days, 14 days, 30 days, 90 days, 6 months, 1 year + +## Setting the time saved by a workflow + +For each workflow, you can set the number of minutes of work a workflow saves you each time it runs. You can configure this by navigating to the workflow, selecting the three dots menu in the top right and selecting settings. There you can update the **Estimated time saved** value and save. + +This setting helps you calculate how much time automating a process saves over time vs the manual effort to complete the same task or process. Once set, n8n calculates the amount of time the workflow saves you based on the number of production executions and displays it on the summary banner and dashboard. + +## Disable or configure insights metrics collection + +If you self-host n8n, you can disable or configure insights and metrics collection using [environment variables](../hosting/configuration/environment-variables/insights/). + +## Insights FAQs + +### Which executions do n8n use to calculate the values in the insights banner and dashboard? + +n8n insights only collects data from production executions (for example, those from active workflows triggered on a schedule or a webhook) from the main (parent) workflow. This means that it doesn't count manual (test) executions or executions from sub-workflows or error workflows. + +### Does n8n use historic execution data when upgrading to a version with insights? + +n8n only starts collecting data for insights once you update to the first supported version (1.89.0). This means it only reports on executions from that point forward and you won't see execution data in insights from prior periods. + +# Keyboard shortcuts and controls + +n8n provides keyboard shortcuts for some actions. + +## Workflow controls + +- **Ctrl** + **Alt** + **n**: create new workflow +- **Ctrl** + **o**: open workflow +- **Ctrl** + **s**: save the current workflow +- **Ctrl** + **z**: undo +- **Ctrl** + **shift** + **z**: redo +- **Ctrl** + **Enter**: execute workflow + +## Canvas + +### Move the canvas + +- **Ctrl** + **Left Mouse Button** + drag: move node view +- **Ctrl** + **Middle mouse button** + drag: move node view +- **Space** + drag: move node view +- **Middle mouse button** + drag: move node view +- Two fingers on a touch screen: move node view + +### Canvas zoom + +- **+** or **=**: zoom in +- **-** or **\_**: zoom out +- **0**: reset zoom level +- **1**: zoom to fit workflow +- **Ctrl** + **Mouse wheel**: zoom in/out + +### Nodes on the canvas + +- **Double click** on a node: open the node details +- **Ctrl/Cmd** + **Double click** on a sub-workflow node: open the sub-workflow in a new tab +- **Ctrl** + **a**: select all nodes +- **Ctrl** + **v**: paste nodes +- **Shift** + **s**: add sticky note + +### With one or more nodes selected in canvas + +- **ArrowDown**: select sibling node below the current one +- **ArrowLeft**: select node left of the current one +- **ArrowRight**: select node right of the current one +- **ArrowUp**: select sibling node above the current one +- **Ctrl** + **c**: copy +- **Ctrl** + **x**: cut +- **D**: deactivate +- **Delete**: delete +- **Enter**: open +- **F2**: rename +- **P**: pin data in node. Refer to [Data pinning](../data/data-pinning/) for more information. +- **Shift** + **ArrowLeft**: select all nodes left of the current one +- **Shift** + **ArrowRight**: select all nodes right of the current one +- **Ctrl/Cmd** + **Shift** + **o** on a sub-workflow node: open the sub-workflow in a new tab + +## Node panel + +- **Tab**: open the Node Panel +- **Enter**: insert selected node into workflow +- **Escape**: close Node panel + +### Node panel categories + +- **Enter**: insert node into workflow, collapse/expand category, open subcategory +- **ArrowRight**: expand category, open subcategory +- **ArrowLeft**: collapse category, close subcategory view + +## Within nodes + +- **=**: in an empty parameter input, this switches to [expressions](../glossary/#expression-n8n) mode. + +This guide outlines a series of tutorials and resources designed to get you started with n8n. + +It's not necessary to complete all items listed to start using n8n. Use this as a reference to navigate to the most relevant parts of the documentation and other resources according to your needs. + +## Join the community + +n8n has an active community where you can get and offer help. Connect, share, and learn with other n8n users: + +- [Ask questions](https://community.n8n.io/t/readme-welcome-to-the-n8n-community/44381) and [make feature requests](https://community.n8n.io/c/feature-requests) in the Community Forum. +- [Report bugs](https://github.com/n8n-io/n8n/issues) and [contribute](https://github.com/n8n-io/n8n/blob/master/CONTRIBUTING.md) on GitHub. + +## Set up your n8n + +If you don't have an account yet, sign up to a [free trial on n8n Cloud](https://app.n8n.cloud/register) or install n8n's community edition with [Docker](../hosting/installation/docker/) (recommended) or [npm](../hosting/installation/npm/). See [Choose your n8n](../choose-n8n/) for more details. + +## Try it out + +Start with the quickstart guides to help you get up and running with building basic workflows. + +- [A very quick quickstart](../try-it-out/quickstart/) +- [A longer introduction](../try-it-out/tutorial-first-workflow/) +- [Build an AI workflow in n8n](../advanced-ai/intro-tutorial/) + +## Structured Courses + +n8n offers two sets of courses. + +### Video courses + +Learn key concepts and n8n features, while building examples as you go. + +- The [Beginner](https://www.youtube.com/playlist?list=PLlET0GsrLUL59YbxstZE71WszP3pVnZfI) course covers the basics of n8n. +- The [Advanced](https://www.youtube.com/playlist?list=PLlET0GsrLUL5bxmx5c1H1Ms_OtOPYZIEG) course covers more complex workflows, more technical nodes, and enterprise features + +### Text courses + +Build more complex workflows while learning key concepts along the way. Earn a badge and an avatar in your community profile. + +- [Level 1: Beginner Course](https://blog.n8n.io/announcing-the-n8n-certification-course-for-beginners-level-1/) +- [Level 2: Intermediate Course](https://blog.n8n.io/announcing-course-level-two/) + +## Self-hosting n8n + +Explore various [self-hosting options in n8n](../hosting/). If you’re not sure where to start, these are two popular options: + +- [Hosting n8n on DigitalOcean](../hosting/installation/server-setups/digital-ocean/) +- [Hosting n8n on Amazon Web Services](../hosting/installation/server-setups/aws/) + +## Build a node + +If you can't find a node for a specific app or a service, you can build a node yourself and share with the community. See what others have built on [npm website](https://www.npmjs.com/search?q=keywords:n8n-community-node-package). + +- [Build a declarative-style node](../integrations/creating-nodes/build/declarative-style-node/) +- [Learn how to build your own n8n nodes (Youtube Video)](https://www.youtube.com/live/OI6zHJ56eW0?si=SMD7L1J5fZ2mf79W) + +## Stay updated + +- Follow new features and bug fixes in the [Release Notes](../release-notes/) +- Follow n8n on socials: [Twitter/X](https://twitter.com/n8n_io), [Discord](https://discord.com/invite/vWwMVThRta), [LinkedIn](https://www.linkedin.com/company/n8n/), [YouTube](https://www.youtube.com/@n8n-io) + +# License Key + +To enable certain licensed features, you must first activate your license. You can do this either through the UI or by setting environment variables. + +## Add a license key using the UI + +In your n8n instance: + +1. Log in as **Admin** or **Owner**. +1. Select **Settings** > **Usage and plan**. +1. Select **Enter activation key**. +1. Paste in your license key. +1. Select **Activate**. + +## Add a license key using an environment variables + +In your n8n configuration, set `N8N_LICENSE_ACTIVATION_KEY` to your license key. If the instance already has an activated license, this variable will have no effect. + +Refer to [Environment variables](../hosting/configuration/configuration-methods/) to learn more about configuring n8n. + +## Allowlist the license server IP addresses + +n8n uses Cloudflare to host the license server. As the specific IP addresses can change, you need to allowlist the [full range of Cloudflare IP addresses](https://www.cloudflare.com/ips/) to ensure n8n can always reach the license server. + +# Log streaming + +Feature availability + +Log Streaming is available on all Enterprise plans. + +Log streaming allows you to send events from n8n to your own logging tools. This allows you to manage your n8n monitoring in your own alerting and logging processes. + +## Set up log streaming + +To use log streaming, you have to add a streaming destination. + +1. Navigate to **Settings** > **Log Streaming**. +1. Select **Add new destination**. +1. Choose your destination type. n8n opens the **New Event Destination** modal. +1. In the **New Event Destination** modal, enter the configuration information for your event destination. These depend on the type of destination you're using. +1. Select **Events** to choose which events to stream. +1. Select **Save**. + +Self-hosted users + +If you self-host n8n, you can configure additional log streaming behavior using [Environment variables](../hosting/configuration/environment-variables/logs/#log-streaming). + +## Events + +The following events are available. You can choose which events to stream in **Settings** > **Log Streaming** > **Events**. + +- Workflow + - Started + - Success + - Failed +- Node executions + - Started + - Finished +- Audit + - User signed up + - User updated + - User deleted + - User invited + - User invitation accepted + - User re-invited + - User email failed + - User reset requested + - User reset + - User credentials created + - User credentials shared + - User credentials updated + - User credentials deleted + - User API created + - User API deleted + - Package installed + - Package updated + - Package deleted + - Workflow created + - Workflow deleted + - Workflow updated +- AI node logs + - Memory get messages + - Memory added message + - Output parser get instructions + - Output parser parsed + - Retriever get relevant documents + - Embeddings embedded document + - Embeddings embedded query + - Document processed + - Text splitter split + - Tool called + - Vector store searched + - LLM generated + - Vector store populated +- Runner + - Task requested + - Response received +- Queue + - Job enqueued + - Job dequeued + - Job completed + - Job failed + - Job stalled + +## Destinations + +n8n supports three destination types: + +- A syslog server +- A generic webhook +- A Sentry client + +# Release notes + +New features and bug fixes for n8n. + +You can also view the [Releases](https://github.com/n8n-io/n8n/releases) in the GitHub repository. + +Latest and Next versions + +n8n releases a new minor version most weeks. The `latest` version is for production use. `next` is the most recent release. You should treat `next` as a beta: it may be unstable. To report issues, use the [forum](https://community.n8n.io/c/questions/12). + +Current `latest`: 1.118.2\ +Current `next`: 1.119.0 + +## How to update n8n + +The steps to update your n8n depend on which n8n platform you use. Refer to the documentation for your n8n: + +- [Cloud](../manage-cloud/update-cloud-version/) +- Self-hosted options: + - [npm](../hosting/installation/npm/) + - [Docker](../hosting/installation/docker/) + +## Semantic versioning in n8n + +n8n uses [semantic versioning](https://semver.org/). 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 [here](0-x/) + +## n8n@1.118.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.118.1...n8n@1.118.2) for this version.\ +**Release date:** 2025-11-05 + +Latest version + +This is the `latest` version. n8n recommends using the `latest` version. The `next` version may be unstable. To report issues, use the [forum](https://community.n8n.io/c/questions/12). + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.119.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.118.0...n8n@1.119.0) for this version.\ +**Release date:** 2025-11-03 + +Next version + +This is the `next` version. n8n recommends using the `latest` version. The `next` version may be unstable. To report issues, use the [forum](https://community.n8n.io/c/questions/12). + +This release includes multiple bug fixes for AI Agent, task runners, editor, and integrations, as well as new features like improved workflow settings, AWS Assume Role credentials, and enhanced security and audit capabilities. + +### Guardrails Node + +The Guardrails node provides a set of rules and policies that control an AI agent's behavior by filtering its inputs and outputs. This helps safeguard from malicious input and from generating unsafe or undesirable responses. There are two operations: + +- Check Text for Violations: Validate text against a set of policies (e.g. NSFW, prompt injection). +- Sanitize Text: Detects and replaces specific data such as PII, URLs, or secrets with placeholders. + +The default presets and prompts are adapted from the open-source [guardrails package](https://github.com/openai/openai-guardrails-js) made available by OpenAI. + +For more info, see [Guardrails documentation](../integrations/builtin/core-nodes/n8n-nodes-langchain.guardrails/) + +### Contributors + +[cesars-gh](https://github.com/cesars-gh)\ +[ongdisheng](https://github.com/ongdisheng) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.118.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.118.0...n8n@1.118.1) for this version.\ +**Release date:** 2025-10-28 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.117.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.117.2...n8n@1.117.3) for this version.\ +**Release date:** 2025-10-28 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.118.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.117.0...n8n@1.118.0) for this version.\ +**Release date:** 2025-10-27 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.117.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.117.1...n8n@1.117.2) for this version.\ +**Release date:** 2025-10-27 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.117.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.117.0...n8n@1.117.1) for this version.\ +**Release date:** 2025-10-24 + +This release contains bug fixes. + +### AI Workflow Builder is now available to Enterprise Cloud users. + +AI Workflow Builder turns prompts into workflows. Describe what you want to build, and n8n will generate a draft workflow by adding, configuring, and connecting nodes for you. From there, you can refine and expand the workflow directly in the editor. + +**What’s new:** + +- Previously available to Starter and Pro users, AI Workflow Builder is now accessible to Enterprise Cloud users as well, with 1,000 monthly credits. +- Supported on n8n version 1.115+. **If you don’t see the feature yet, open /settings/usage to trigger a license refresh.** +- We’ve fixed a bug and now cloud users on v1.117.1 onwards will have access to a more reliable builder. +- We’re currently working on bringing AI Workflow Builder to self-hosted users as well, including Community, Business, and Enterprise. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.117.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.116.0...n8n@1.117.0) for this version.\ +**Release date:** 2025-10-21 + +This release contains bug fixes. + +### Contributors + +[jackfrancismurphy](https://github.com/jackfrancismurphy)\ +[JiriDeJonghe](https://github.com/JiriDeJonghe)\ +[ramkrishna2910](https://github.com/ramkrishna2910)\ +Oracle and/or its affiliates ([sudarshan12s](https://github.com/sudarshan12s)) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.116.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.116.1...n8n@1.116.2) for this version.\ +**Release date:** 2025-10-21 + +This release contains a bug fix. + +## n8n@1.115.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.115.3...n8n@1.115.4) for this version.\ +**Release date:** 2025-10-21 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.116.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.116.0...n8n@1.116.1) for this version.\ +**Release date:** 2025-10-14 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.116.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.115.0...n8n@1.116.0) for this version.\ +**Release date:** 2025-10-13 + +This release contains bug fixes. + +### Data migration tool + +You can now easily migrate n8n data between different database types. This new tooling currently supports SQLite and Postgres, making the transition to a scaling database choice simpler, allowing you to take your data with you. + +The tooling comes in the form of two new CLI commands, `export:entities` and `import:entities` + +**`Export`** The new export command lets you export data from your existing n8n database (SQLite / Postgres), producing a set of encrypted files within a compressed directory for you to move around and use with the import commands. + +For details, see [Export entities](../hosting/cli-commands/#export-entities) + +**`Import`** The new import command allows you to read from a compressed and encrypted set of files generated from the new export command, and import them in to your new database of choice (SQLite / Postgres) to be used with your n8n instance. + +For details, see [Import entities](../hosting/cli-commands/#import-entities) + +### Contributors + +[JHTosas](https://github.com/JHTosas)\ +[clesecq](https://github.com/clesecq)\ +[Gulianrdgd](https://github.com/Gulianrdgd)\ +[tishun](https://github.com/tishun) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.116.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.115.0...n8n@1.116.0) for this version.\ +**Release date:** 2025-10-13 + +This release contains bug fixes. + +### Contributors + +[JHTosas](https://github.com/JHTosas)\ +[clesecq](https://github.com/clesecq)\ +[Gulianrdgd](https://github.com/Gulianrdgd)\ +[tishun](https://github.com/tishun) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.115.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.115.2...n8n@1.115.3) for this version.\ +**Release date:** 2025-10-14 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.115.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.115.1...n8n@1.115.2) for this version.\ +**Release date:** 2025-10-10 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.114.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.114.3...n8n@1.114.4) for this version.\ +**Release date:** 2025-10-07 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.115.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.114.0...n8n@1.115.0) for this version.\ +**Release date:** 2025-10-06 + +This release contains bug fixes. + +### AI Workflow Builder (Beta) + +**AI Workflow Builder** turns your natural language prompts into working automations. Describe what you want to build, and n8n will generate a draft workflow by adding and configuring nodes and wiring up the logic for you. From there, you can refine, expand, or adjust the workflow directly in the editor. + +This feature helps you move from idea to implementation faster and without losing technical control. It’s especially helpful when starting from a blank canvas, validating an approach, or exploring new nodes and capabilities. Multi-turn interaction lets you iterate in conversation, turning your ideas into structured, production-ready workflows step by step. + +Learn more about how we we’re building this feature in our [forum post](https://community.n8n.io/t/ai-powered-workflow-building-coming-soon/196499). + +[](/_video/release-notes/AI_Workflow_Builder.webm) + +**Availability:** + +- This feature is initially going to be available for Cloud users on the 14-day Trial, Starter and Pro plans. +- Availability for Enterprise users on Cloud will follow in a future update. +- We are actively exploring the best way to bring this feature to self-hosted users. + +**Rollout timing:** + +- To ensure the smoothest experience for all users, this feature will be rolled out to users on version 1.115.0 over the course of a week so you may not have access to the feature immediately when you upgrade to 1.115.0. + +**Credit limits by plan:** This feature will have monthly credit limits [by plan](https://n8n.io/pricing/). + +- Each prompt/interaction with the AI Workflow Builder consumes one credit. +- Trial users have access to 20 credits, Starter plans have 50 per month and Pro plans will have 150 credits per month. +- At this time, there will not be a way to access additional credits within your plan, however we are we are exploring this. + +Learn more about AI Workflow Builder in [documentation](https://docs.n8n.io/advanced-ai/ai-workflow-builder/). + +### Source Control: Added HTTPS support + +You can now connect to Git repositories via HTTPS in addition to SSH, making Source Control usable in environments where SSH is restricted. + +HTTPS is now supported as a connection type in Environments. + +### Contributors + +[baileympearson](https://github.com/baileympearson)\ +[h40huynh](https://github.com/h40huynh)\ +[Ankit-69k](https://github.com/Ankit-69k)\ +[francisfontoura](https://github.com/francisfontoura)\ +[iocanel](https://github.com/iocanel) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.114.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.114.2...n8n@1.114.3) for this version.\ +**Release date:** 2025-10-06 + +This release contains bug fixes. + +## n8n@1.114.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.114.1...n8n@1.114.2) for this version.\ +**Release date:** 2025-10-02 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.114.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.114.0...n8n@1.114.1) for this version.\ +**Release date:** 2025-10-02 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.114.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.113.0...n8n@1.114.0) for this version.\ +**Release date:** 2025-09-29 + +This release contains core updates, editor improvements, project updates, performance improvements, and bug fixes. + +### Contributors + +[nealzhu3](https://github.com/nealzhu3) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.113.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.113.2...n8n@1.113.3) for this version.\ +**Release date:** 2025-09-26 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.6 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.5...n8n@1.112.6) for this version.\ +**Release date:** 2025-09-26 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.113.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.113.1...n8n@1.113.2) for this version.\ +**Release date:** 2025-09-24 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +### Python task runner + +This version introduces the **Python task runner** as a beta feature. This feature secures n8n's Python sandbox and enables users to run real Python modules in n8n workflows. The original Pyodide-based implementation will be phased out. + +This is a **breaking change** that replaces Pyodide - see [here](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.code/#python-native-beta) for a list of differences. Any Code node set to the legacy `python` parameter will need to be manually updated to use the new `pythonNative` parameter. Any Code node script set to `python` and relying on Pyodide syntax is likely to need to be manually adjusted to account for breaking changes. + +- For self-hosting users, see [here](https://docs.n8n.io/hosting/configuration/task-runners/#setting-up-external-mode) for deployment instructions for task runners going forward and how to install extra dependencies. +- On n8n Cloud, this will be a gradual transition. If in your n8n Cloud instance the Code node offers an option named "Python (Native) (Beta)", then your instance has been transitioned to native Python and you will need to look out for any breaking changes. Imports are disabled for security reasons at this time. + +The native Python runner is currently in beta and is subject to change as we find a balance between security and usability. Your feedback is welcome. + +## n8n@1.112.5 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.4...n8n@1.112.5) for this version.\ +**Release date:** 2025-09-24 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.113.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.113.0...n8n@1.113.1) for this version.\ +**Release date:** 2025-09-23 + +This release contains bug fixes. + +### Data tables + +We’re excited to introduce **data tables**, bringing built-in data storage to n8n. You can now store and query structured data directly inside the platform, without relying on external databases for many common automation scenarios. Track workflow state between runs, store tokens or session data, keep product or customer reference tables, or stage intermediate results for multi-step processes. + +Previously, persisting data meant provisioning and connecting to an external store such as Redis or Google Sheets. That added credential setup, infrastructure overhead, latency, and constant context switching. **Data tables** eliminate that friction and keeps your data easily editable and close to your workflows. + +Data tables are available today on all plans. They currently support numbers, strings, and datetimes with JSON support coming soon. On Cloud, each instance can store up to 50 MB. On self-hosted setups, the default is also 50 MB, but this limit can be adjusted if your infrastructure allows. + +[Overview of data tables](https://www.youtube.com/watch?v=ljkiIkt6lZ4) + +🛠️ **How to:** + +**Create a data table** + +- From the canvas, open the **Create workflow** dropdown and select **Create Data table**. +- Or, go to the **Overview** panel on the left-side navigation bar and open the **Data tables** tab. + +**Use a data table in your workflow** + +- Add the **Data table node** to your workflow to get, update, insert, upsert, or delete rows. + +**Adjust the storage limit** (self-hosted only) + +- Change the default 50 MB limit with the environment variable: `N8N_DATA_TABLES_MAX_SIZE_BYTES`. [See configuration docs](https://docs.n8n.io/hosting/configuration/configuration-methods/). + +🧠**Keep in mind** + +- Data tables don’t currently support foreign keys or default values. +- For now, all data tables are accessible to everyone in a project. More granular permissions and sharing options are planned. + +Learn more about [**data tables**](../data/data-tables/) and the [**Data table node**](../integrations/builtin/core-nodes/n8n-nodes-base.datatable/). + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.3...n8n@1.112.4) for this version.\ +**Release date:** 2025-09-23 + +This release contains an editor improvement. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.113.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.0...n8n@1.113.0) for this version.\ +**Release date:** 2025-09-22 + +This release contains core updates, editor improvements, a new node, node updates, and bug fixes. + +### SSO improvements + +We’ve made updates to strengthen Single Sign-On (SSO) reliability and security, especially for enterprise and multi-instance setups. + +- OIDC and SAML sync in multi-main setups \[version: 1.113.0\]: In multi-main deployments, updates to SSO settings are now synchronized across all instances, ensuring consistent login behavior everywhere. +- Enhanced OIDC integration \[version 1.111.0\]: n8n now supports OIDC providers that enforce state and nonce parameters. These are validated during login, providing smoother and more secure Single Sign-On. + +### Filter insights by project + +We've added project filtering to insights, enabling more granular reporting and visibility into individual project performance. + +Filter insights + +### Contributors + +[ongdisheng](https://github.com/ongdisheng) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.2...n8n@1.112.3) for this version.\ +**Release date:** 2025-09-19 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.111.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.111.0...n8n@1.111.1) for this version.\ +**Release date:** 2025-09-19 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.110.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.110.1...n8n@1.110.2) for this version.\ +**Release date:** 2025-09-19 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.1...n8n@1.112.2) for this version.\ +**Release date:** 2025-09-18 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.112.0...n8n@1.112.1) for this version.\ +**Release date:** 2025-09-17 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.112.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.111.0...n8n@1.112.0) for this version.\ +**Release date:** 2025-09-15 + +This release contains API improvements, core updates, editor improvements, node updates, and bug fixes. + +### Additional API Endpoints versions + +We’ve made several updates to the Executions API: + +- Execution details: `GET /executions` now includes *status* and *workflow_name* in the response. +- Retry execution endpoint: Added new public API endpoints to retry failed executions. +- Additional filters: You can now filter executions by running or canceled status. + +### Enhancements to workflow diff + +We added a several updates on workflows diffs as well: + +- Better view in Code nodes and Stickies: Workflow diffs now highlight changes per line instead of per block, making edits easier to review and understand. +- Enable/Disable sync: You can now enable or disable sync in the viewport, letting you compare a workflow change in one view without affecting the other. + +Workflow diff + +### Contributors + +[GuraaseesSingh](https://github.com/GuraaseesSingh)\ +[jabbson](https://github.com/jabbson)\ +[ongdisheng](https://github.com/ongdisheng) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.111.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.110.0...n8n@1.111.0) for this version.\ +**Release date:** 2025-09-08 + +This release contains core updates, API improvements, node updates, and bug fixes. + +### Contributors + +[abellion](https://github.com/abellion)\ +[cesars-gh](https://github.com/cesars-gh)\ +[durran](https://github.com/durran) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.110.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.110.0...n8n@1.110.1) for this version.\ +**Release date:** 2025-09-03 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.109.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.109.1...n8n@1.109.2) for this version.\ +**Release date:** 2025-09-03 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.110.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.109.0...n8n@1.110.0) for this version.\ +**Release date:** 2025-09-01 + +This release contains core updates, editor improvements, node updates, performance improvements, and bug fixes. + +### Contributors + +[heyxmirko](https://github.com/heyxmirko) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.109.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.109.0...n8n@1.109.1) for this version.\ +**Release date:** 2025-08-27 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.108.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.108.1...n8n@1.108.2) for this version.\ +**Release date:** 2025-08-27 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.109.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.108.0...n8n@1.109.0) for this version.\ +**Release date:** 2025-08-25 + +This release contains core updates, editor improvements, node updates, performance improvements, and bug fixes. + +### Contributors + +[naXa777](https://github.com/naXa777)\ +[prettycode2022](https://github.com/prettycode2022)\ +[oppai](https://github.com/oppai) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.107.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.107.3...n8n@1.107.4) for this version.\ +**Release date:** 2025-08-20 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.108.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.108.0...n8n@1.108.1) for this version.\ +**Release date:** 2025-08-20 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.107.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.107.2...n8n@1.107.3) for this version.\ +**Release date:** 2025-08-18 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.108.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.107.0...n8n@1.108.0) for this version.\ +**Release date:** 2025-08-18 + +This release contains a new CLI tool, editor improvements, node updates, performance improvements, and bug fixes. + +### Workflow Diff + +For teams working across different environments, deployments often involve multiple people making changes at different times. Without a clear view of those changes, it’s easy to miss something important. + +[Workflow Diff](../source-control-environments/using/compare-changes/) gives you an easy and visual way to review workflow changes before you deploy them between environments. + +With it, you can: + +- Quickly see what’s been added, changed, or deleted, with clear colour highlights. +- Easily see important settings changes on a workflow. +- Check changes inside each node, and spot connector updates, with a side-by-side view of its settings. +- Get a quick count of all changes to understand the size of a deployment. + +Workflow Diff + +Workflow Diff eases the review and approval of changes before deployment, enabling teams to collaborate on workflows without breaking existing automations or disrupting production. It’s one step further in integrating DevOps best practices in n8n. + +Now available for Enterprise customers using Environments. + +### Contributors + +[ManuLasker](https://github.com/ManuLasker)\ +[EternalDeiwos](https://github.com/EternalDeiwos)\ +[jreyesr](https://github.com/jreyesr) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.107.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.107.1...n8n@1.107.2) for this version.\ +**Release date:** 2025-08-15 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.107.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.107.0...n8n@1.107.1) for this version.\ +**Release date:** 2025-08-14 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.106.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.106.2...n8n@1.106.3) for this version.\ +**Release date:** 2025-08-11 + +This release contains a backported update. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.107.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.106.0...n8n@1.107.0) for this version.\ +**Release date:** 2025-08-11 + +This release contains bug fixes. + +### Contributors + +[Amsal1](https://github.com/Amsal1)\ +[andrewzolotukhin](https://github.com/andrewzolotukhin)\ +[DMA902](https://github.com/DMA902)\ +[fkowal](https://github.com/fkowal)\ +[Gulianrdgd](https://github.com/Gulianrdgd) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.106.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.106.1...n8n@1.106.2) for this version.\ +**Release date:** 2025-08-08 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.106.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.106.0...n8n@1.106.1) for this version.\ +**Release date:** 2025-08-07 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.105.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.105.3...n8n@1.105.4) for this version.\ +**Release date:** 2025-08-07 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.105.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.105.2...n8n@1.105.3) for this version.\ +**Release date:** 2025-08-05 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.106.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.105.0...n8n@1.106.0) for this version.\ +**Release date:** 2025-08-04 + +This release contains performance improvements, core updates, editor improvements, node updates, a new node, and bug fixes. + +### **No more limit of active workflows and new self-hosted Business Plan** + +We have rolled out a new pricing model to make it easier for builders of all sizes to adopt and scale automation with n8n. + +***What’s new*** + +**No more limit of active workflows.** + +All n8n plans, from Starter to Enterprise, now include unlimited users, workflows, and steps. Our pricing is based on the volume of executions. Meaning you can build and test as many workflows as you want, including complex, data-heavy, or long-running automations, without worrying about quotas. + +**New self-hosted Business Plan for growing teams** + +Designed for SMBs and mid-sized companies, the Business Plan includes features such as: + +- 6 shared projects +- SSO, SAML and LDAP +- Different environments +- Global variables +- Version control using Git +- 30 days of Insights + +Please note that this plan only includes support from our community forum. For dedicated support we recommend upgrading to our Enterprise plan. + +**Enterprise pricing now scales with executions** + +Enterprise plans no longer use workflow-based pricing, and is now also based on the volume of executions. + +***What you need to do*** + +To ensure these changes apply to your account, update your n8n instance to the latest version. + +[Read the blog](https://blog.n8n.io/build-without-limits-everything-you-need-to-know-about-n8ns-new-pricing/) for full details. + +### Contributors + +[baruchiro](https://github.com/baruchiro)\ +[killthekitten](https://github.com/killthekitten)\ +[baileympearson](https://github.com/baileympearson)\ +[Yingrjimsch](https://github.com/Yingrjimsch)\ +[joshualipman123](https://github.com/joshualipman123) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.105.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.105.1...n8n@1.105.2) for this version.\ +**Release date:** 2025-08-01 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.105.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.105.0...n8n@1.105.1) for this version.\ +**Release date:** 2025-08-01 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.104.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.104.1...n8n@1.104.2) for this version.\ +**Release date:** 2025-07-31 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.105.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.104.0...n8n@1.105.0) for this version.\ +**Release date:** 2025-07-28 + +This release contains core updates, editor improvements, node updates, and bug fixes. + +### **Respond to Chat node** + +With the [\*\*Respond to Chat](../integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat/) node\*\*, you can now access Human-in-the-Loop functionality natively in n8n Chat. + +Enable conversational experiences where you can ask for clarification, request approval before taking further action, and get back intermediate results — all within a single workflow execution. + +This unlocks multi-turn interactions that feel more natural and reduce the number of executions required. It is ideal for building interactive AI use cases like conversational forms, branched workflows based on user replies, and step-by-step approvals. + +🛠️ **How to:** + +- Add a **Chat Trigger** node and select **Using Respond Nodes** for the **Response mode** +- Place the **Respond to Chat** node anywhere in your workflow to send a message into the Chat and optionally wait for the user to input a response before continuing execution of the workflow steps. + +[](/_video/release-notes/Respond-to-chat.webm) + +### Contributors + +[dana-gill](https://github.com/dana-gill) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.104.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.104.0...n8n@1.104.1) for this version.\ +**Release date:** 2025-07-23 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.103.2 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.103.1...n8n@1.103.2) for this version.\ +**Release date:** 2025-07-22 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.104.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.103.0...n8n@1.104.0) for this version.\ +**Release date:** 2025-07-21 + +\======= + +This release contains core updates, editor improvements, a new node, node updates, and bug fixes. + +### Contributors + +[nunulk](https://github.com/nunulk)\ +[iaptsiauri](https://github.com/iaptsiauri)\ +[KGuillaume-chaps](https://github.com/KGuillaume-chaps) + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.101.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.101.2...n8n@1.101.3) for this version.\ +**Release date:** 2025-07-18 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.102.4 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.102.3...n8n@1.102.4) for this version.\ +**Release date:** 2025-07-17 + +This release contains a bug fix. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.103.1 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.103.0...n8n@1.103.1) for this version.\ +**Release date:** 2025-07-17 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.102.3 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.102.2...n8n@1.102.3) for this version.\ +**Release date:** 2025-07-14 + +This release contains bug fixes. + +For full release details, refer to [Releases](https://github.com/n8n-io/n8n/releases) on GitHub. + +## n8n@1.103.0 + +View the [commits](https://github.com/n8n-io/n8n/compare/n8n@1.102.0...n8n@1.103.0) for this version.\ +**Release date:** 2025-07-14 + +This release contains core updates, editor improvements, new nodes, node improvements, and bug fixes. + +### **Chat streaming** + +No more waiting for full responses to load when using the n8n chat interface. **Streaming** now delivers AI-generated text replies word by word so users can read messages as they’re being generated. It feels faster, smoother, and more like what people expect from chat experiences. + +Streaming is available in public chat views (hosted or embedded) and can be used in custom apps via webhook. + +🛠️ How-to + +Configure streaming in the Node Details View of these nodes: + +- Chat Trigger node: Options>Add Field>Response Mode>Streaming +- Webhook node: Respond>Streaming +- AI Agent node: Add option> Enable streaming + +[](/_video/release-notes/streaming.webm) + +### Improved instance user list with more visibility + +The instance user list has been updated with a new table layout and additional details to help admins manage access more easily. + +You can now: + +- See total users and filter by name or email +- View which projects each user has access to +- Whether a user has enabled 2FA and sort based on that +- See the last active date for each user + +This makes it easier to audit user activity, identify inactive accounts, and understand how access is distributed across your instance. + +### Webhook HTML responses + +Starting with this release, if your workflow sends an HTML response to a webhook, n8n automatically wraps the content in an `