Skip to main content

Merge Node

The Merge Node combines the outputs of multiple nodes into a single output — without writing any Python code. Previously, merging outputs from several nodes required a Python Code step to manage variables and input/output handling. The Merge Node makes the same result available to non-technical users with a no-code configuration and build-time type validation.

This step is most useful in advanced (graph) tools, where multiple branches run and you want to bring their results back together.

Steps to Use the Merge Node​

Step 1: Add the Merge Node​

  • Drag a Merge Node from the predefined tool steps onto the canvas.

Step 2: Set the Number of Inputs​

  • Define how many incoming connections you want to merge (2, 3, … up to a maximum of 10).
  • Connect each node you want to merge to one of these inputs.
  • If an input is left unconnected, it is not considered during execution.

Step 3: Choose the Trigger Rule​

The Merge Node uses the standard trigger rules:

  • Any Success — the node returns the first successful output. No additional validation is applied.
  • All Success — the node waits for all connected inputs to succeed, then merges them. The output data types of all connected nodes must match. If they don't, the node raises a validation error indicating that the data types do not match.

Step 4: Run the Step​

On execution:

  • For Any Success, the node returns the first successful upstream output.
  • For All Success, the node validates that input data types match, then merges them sequentially according to type.

How outputs are merged (All Success)​

When the All Success trigger is chosen, outputs are combined sequentially based on their type:

Strings are concatenated:

  • Input A = "Hello"
  • Input B = "World"
  • Output = "Hello World"

Objects are collected into an array:

  • Input A = {id:1, name:"A"}
  • Input B = {id:2, name:"B"}
  • Output = [{id:1, name:"A"}, {id:2, name:"B"}]

Arrays of the same data type are concatenated:

  • Input A = [1,2]
  • Input B = [3,4]
  • Output = [1,2,3,4]

Tips for Effective Use​

  • Match types for All Success: All connected inputs must share the same output type, or the node fails validation at build time.
  • Use Any Success for fallbacks: When you only need whichever branch finished first, Any Success avoids waiting on the rest.
  • Mind the limit: Up to 10 inputs can be merged in a single node.
  • Pair with branching: Combine the Merge Node with parallel branches to fan out work and bring it back together.

If you have any questions or need further assistance, please contact the helpdesk ([email protected]).