Merge Node

The merge node allows you to combine different execution paths from your pipeline into a single flow. Use a merge node when you want to consolidate multiple branches (typically coming from a condition node) back into a unified pipeline flow.

​

Node Inputs

1. Function: The strategy for merging multiple inputs
   • Type: Dropdown
   • Options:
     • Pick First: Takes the first (by time) valid input from connected paths
     • Join All: Combines all inputs into a list
2. Paths: The different input paths to be merged.
   • Type: List<T>, where T is the type selected in the Type dropdown
   • Each field represents a potential incoming path
   • You can dynamically add or remove input paths using the “Add Path” button

​

Node Parameters

1. Type: The data type for inputs and outputs
   • Type: Dropdown
   • Available options correspond to standard data types (Text, Number, etc.)

​

Node Outputs

If Function is “Pick First”

1. Output: The merged result
   • Type: T
   • Example usage: {{merge_0.output}}

If Function is “Join All”

1. Output: The merged result
   • Type: List<T>
   • Example usage: {{merge_0.output}}

​

Considerations

• The merge node is typically used in conjunction with the condition node to combine different execution paths.
• When using “Pick First”, the output will be a single value of the selected type as it’ll pick the first available incoming value.
• When using “Join All”, the output will be a list of values of the selected type as it’ll join all incoming values.
• All input paths must match the selected type in the Type dropdown.
• Empty or skipped paths are handled gracefully by the node.

​

Example: Written

The below example shows a pipeline that processes customer data differently based on their status using a condition node, then merges the results:

1. Condition node checks customer status:
   • Path 0: VIP customer processing
   • Path 1: New customer processing
   • Path else: Regular customer processing
2. Merge node combines the processing results:
   • Type: Text
   • Function: Join All
   • Fields:
     • Path 1: {{vip_processing.output}}
     • Path 2: {{new_customer_processing.output}}
     • Path else: {{regular_customer_processing.output}}

The merge node collects all processing results into a single list that can be used by downstream nodes.

​

Example: Visual

In the below example, we have a condition node with two paths.

1. If text_0 = hello, then path 0 will execute (which is false; text_0 = orange)
2. If text_1 = apple, then path 1 will execute (which is true)
3. Path 1 executes, and we merge both paths together before displaying the output. Path 1 is a text node that prints out text_1 (“apple”). Hence, the output is apple.