Merge
Merge geometry, shapes, fields, or a mixed list of inputs into one collection.
What it does
Merge folds everything wired into it into one collection. Inputs of the same kind, all geometry, all shapes, all images, concatenate into a single container of that kind: two point clouds become one point cloud, two meshes become one mesh. Mixed kinds fall back to a combined list, so downstream nodes that read multiple sources still see every piece.
The Group node keeps each input as its own separate layer or object. Merge collapses rows, columns and topology into one flat collection, with no way to pull the pieces apart afterwards.
An optional Fuse pass welds points that land within a distance of each other into one, closing seams where separately built pieces meet.
When to use it
Several separate pieces of geometry, or several scattered point sets, treated as one object from here on.
Shapes or curves from different branches of the graph combined into a single collection for a downstream node.
Two pieces sharing a seam: enable Fuse to weld the touching points.
A downstream node that expects one collection while several outputs feed it.
| Parameter | Type | Default |
|---|---|---|
inputs | Any | Collection(AttributedCollection { col... |
add_source_attribute | Boolean | true |
fuse | Boolean | false |
fuse_distance | Number | 0.001 |
snap_mode | String | "Average" |
attribute_mode | String | "Average" |
cross_input_only | Boolean | false |
Gotchas
Merge flattens identity. For each input to stay a distinct, separately selectable object later in the graph, use Group: a merged collection has no memory of which input a point came from.
Mixing kinds, an image alongside geometry for example, merges without an error but produces a combined list rather than one unified collection. Downstream nodes built to consume a single geometry collection may pick up only part of a mixed merge.
Fuse currently welds any points within Fuse Distance of each other, wherever they occur, including points already close together inside a single input, not only at the seams between inputs. On source geometry with dense detail, a large Fuse Distance can weld more than intended.
Worked example
Add a Merge node.
Wire two or more geometry, shape, or curve outputs into Inputs.
If the pieces should share a seam, enable Fuse and set Fuse Distance to close the gap.
Check the Fused Count output to confirm how many points were welded away.
See also
Boolean · Scatter · Spawn · Collections