List
Uncontrolled node
Overview
The List node creates a static list (array) data structure that can be used throughout your workflow. This node is useful for defining collections of data such as configuration options, lookup tables, or lists of items to process.
Unlike dynamic lists created by nodes like Split Text or Read CSV, the List node contains data that is defined directly in the node's properties panel using a dedicated list editor interface.
Inputs
This node has no input sockets. The list content is configured via the properties panel.
Outputs
| Output | Type | Description |
|---|---|---|
| output | Data | Contains the list as a standard array. If no items are defined, returns an empty array []. |
Properties
| Property | Type | Description | Default |
|---|---|---|---|
| list | List | Opens a list editor in the properties panel where you can add, remove, and reorder items. Supports primitive values (text, numbers, booleans) and nested objects. | Empty list |
Runtime Behavior
When the workflow runs, the node converts the internal list structure into a standard JavaScript array and outputs it via the output socket.
If the list property is empty or undefined, the node outputs an empty array. The node does not trigger events and runs passively whenever its output is requested by downstream nodes.
Example Usage
Static Configuration List Connect the List node to a For Each node to iterate over a predefined set of values:
- Add a List node to your workflow
- Open the properties panel and click into the list field
- Add items:
"Option A","Option B","Option C" - Connect the output to a For Each node's object input
- The For Each node will iterate through each string in the list
Lookup Table Create a list of objects for mapping values:
[
{"code": "US", "name": "United States"},
{"code": "CA", "name": "Canada"},
{"code": "UK", "name": "United Kingdom"}
]
Connect this to a Map List or Filter List node to transform or query the data.