mirror of
https://github.com/n8n-io/n8n-docs.git
synced 2026-04-12 07:06:20 +07:00
85 lines
4.1 KiB
Markdown
85 lines
4.1 KiB
Markdown
---
|
|
#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4
|
|
description: A node is an entry point for retrieving data, a function to process data, or an exit for sending data.
|
|
contentType: howto
|
|
---
|
|
|
|
# Nodes
|
|
|
|
Nodes are the key building blocks of a workflow. They perform a range of actions, including:
|
|
|
|
* Starting the workflow.
|
|
* Fetching and sending data.
|
|
* Processing and manipulating data.
|
|
|
|
n8n provides a collection of built-in nodes, as well as the ability to create your own nodes. Refer to:
|
|
|
|
* [Built-in integrations](/integrations/builtin/node-types/) to browse the node library.
|
|
* [Community nodes](/integrations/community-nodes/installation/) for guidance on finding and installing community-created nodes.
|
|
* [Creating nodes](/integrations/creating-nodes/overview/) to start building your own nodes.
|
|
|
|
|
|
## Add a node to your workflow
|
|
|
|
### Add a node to an empty workflow
|
|
|
|
1. Select **Add first step**. n8n opens the nodes panel, where you can search or browse trigger nodes.
|
|
2. Select the trigger you want to use.
|
|
|
|
/// note | Choose the correct app event
|
|
If you select **On App Event**, n8n shows a list of all the supported services. Use this list to browse n8n's integrations and trigger a workflow in response to an event in your chosen service. Not all integrations have triggers. To see which ones you can use as a trigger, select the node. If a trigger is available, you'll see it at the top of the available operations list.
|
|
|
|
For example, this is the trigger for Asana:
|
|
|
|
|
|
///
|
|
|
|
### Add a node to an existing workflow
|
|
|
|
Select the **Add node** <span class="inline-image">{.off-glb}</span> connector. n8n opens the nodes panel, where you can search or browse all nodes.
|
|
|
|
--8<-- "_snippets/integrations/builtin/node-operations.md"
|
|
|
|
## Node controls
|
|
|
|
To view node controls, hover over the node on the canvas:
|
|
|
|
* **Test step** <span class="inline-image">{.off-glb}</span>: Run the node.
|
|
* **Deactivate** <span class="inline-image">{.off-glb}</span>: Deactivate the node.
|
|
* **Delete** <span class="inline-image">{.off-glb}</span>: Delete the node.
|
|
* **Node context menu** <span class="inline-image">{.off-glb}</span>: Select node actions. Available actions:
|
|
* Open node
|
|
* Test step
|
|
* Rename node
|
|
* Deactivate node
|
|
* Pin node
|
|
* Copy node
|
|
* Duplicate node
|
|
* Select all
|
|
* Clear selection
|
|
* Delete node
|
|
|
|
## Node settings
|
|
|
|
The node settings under the **Settings** tab allow you to control node behaviors and add node notes.
|
|
|
|
When active or set, they do the following:
|
|
|
|
* **Request Options**: Select **Add Option** to view and select these options.
|
|
- **Batching**: Control how to batch large numbers of input items.
|
|
- **Ignore SSL Issues**: Download the response even if SSL validation isn't possible.
|
|
- **Proxy**: Use this if you need to specify an HTTP proxy.
|
|
- **Timeout**: Set a timeout for the request in ms.
|
|
* **Always Output Data**: The node returns an empty item even if the node returns no data during execution. Be careful setting this on IF nodes, as it could cause an infinite loop.
|
|
* **Execute Once**: The node executes once, with data from the first item it receives. It doesn't process any extra items.
|
|
* **Retry On Fail**: When an execution fails, the node reruns until it succeeds.
|
|
* **On Error**:
|
|
- **Stop Workflow**: Halts the entire workflow when an error occurs, preventing further node execution.
|
|
- **Continue**: Proceeds to the next node despite the error, using the last valid data.
|
|
- **Continue (using error output)**: Continues workflow execution, passing error information to the next node for potential handling.
|
|
|
|
You can document your workflow using node notes:
|
|
|
|
* **Notes**: Note to save with the node.
|
|
* **Display note in flow**: If active, n8n displays the note in the workflow as a subtitle.
|