Get Value
Uncontrolled node
Overview
Extracts a value from an object, dictionary, or list using a specified path. This node supports nested property access via dot notation (e.g., user.name or items.0.value). If the specified path does not exist in the object, the node outputs the string 'undefined'.
The path input supports Handlebars-style template variables (e.g., {{variableName}}), allowing dynamic path construction using values from other nodes or workflow variables.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| Object | Data | The object, dictionary, or list to read from. | - |
| Path | Text | The path to the value using dot notation for nested properties (e.g., user.name, items.0.id). Supports template variables like {{key}}. | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Value | Data | The extracted value at the specified path, or the string 'undefined' if the path does not exist. |
Runtime Behavior
As an uncontrolled node, Get Value executes immediately whenever its inputs change. It does not require an event trigger to run. The node uses advanced dereferencing to navigate nested data structures, supporting both object properties and array indices in the path string.
If the path contains template variables (e.g., users.{{index}}.name), these are resolved first using available workflow variables and node inputs before accessing the object.
Example
Extracting a nested property:
- Object input:
{"user": {"name": "Alice", "email": "alice@example.com"}} - Path input:
user.name - Value output:
"Alice"
Accessing array elements:
- Object input:
[{"name": "Alice"}, {"name": "Bob"}] - Path input:
1.name - Value output:
"Bob"
Using template variables in path:
- Object input:
{"users": [{"id": "u1"}, {"id": "u2"}]} - Path input:
users.{{index}}.id(whereindexis a variable with value0) - Value output:
"u1"