Skip to main content

Merge as Pairs Node (Shapes > Merge)

What it does

This node merges items from two input nodes as pairs, creating new shape trees that each contain two paired items.

Use it for

  • Merging items from two nodes as pairs.
  • For example, to create a list structure: The first node contains all Lbl items, the second all LBody items. Merge them as pairs to create the structure for the LI items.

How to use it

  1. Drag and drop the node from the Node Library into your template:
    Node Library > Folder Shapes > Folder Merge
  2. Connect the node with other nodes in the Data Flow of your template. Use two nodes as input.
  3. Specify the settings in the Node Properties task pane.

Node Input

Connect two nodes from the Data Flow to the First Items and Second Items input ports. Items will be paired in this order. For consistent pairing, both input nodes should contain the same number of items.

Node Output

Paired Items: Each item from the first node is paired with the corresponding item from the second node.
Each pair is grouped into a new shape tree. 

If the numbers of items in the two input ports differ, the remaining unpaired items are still wrapped in a new group container, containing only a single item.

Node Properties

Node Name

You can assign a custom name to the node to help identify its purpose within your template.


Pair Name

You can assign a custom name to the new paired items to help identify them in further shape trees.