Merge Lists
Combine several lists into one. Concatenate appends them in connection order, and Zip merges the items that share a position. Optionally drop duplicates.
The Merge Lists node combines several lists into one. Concatenate appends the lists one after another, in the order you connected them. Zip (merge items) merges the items that share a position into one item. With Zip, you can add one shared object to every item of a longer list. An optional switch removes duplicates after the merge. The node is free.
When to use it
- Join the results of two scrapes into one list.
- Combine prompts from two sources into one batch.
- Add the same settings object, such as brand details, to every item of a product list.
Quick start
Add the node
Press Tab on the canvas and choose Automate › Lists & Batching › Merge Lists.
Connect two or more lists
Wire each list into the Lists input. With Concatenate, the first connection's items come first.
Choose a mode
Open the settings panel and choose Concatenate or Zip (merge items). Enable Remove duplicates after merge to drop repeats.
Run it
The Merged output carries the combined list. After a run, the panel previews the first items and shows how many there are.
Inputs and outputs
| Input or output | Accepts or sends | What it does |
|---|---|---|
| Lists | Two or more lists | The lists to combine. A node that sends a single value counts as a list with one item. |
| Merged | A list | The combined list. |
Settings
| Setting | What it does |
|---|---|
| Mode | Concatenate, the default, appends the lists in the order of their connections. Zip (merge items) merges the items that share a position. In Zip mode, shorter lists start again from their first item, and a single object is merged into every item of the longer list. |
| Remove duplicates after merge | Off by default. On drops repeated items, compared by value, after the merge. |
How Zip merges items
Zip is made for lists of JSON objects. With a product list and one shared object, every product receives the shared fields.
| Connection | Value |
|---|---|
| First list | [{ "name": "Mug" }, { "name": "Cap" }] |
| Second connection | { "brand": "Nodaro" } |
| Merged output | [{ "name": "Mug", "brand": "Nodaro" }, { "name": "Cap", "brand": "Nodaro" }] |
Credits
Merge Lists is free.
Tips
- Connect in the order you want. Concatenate follows the order of the connections, so connect the list that should come first before the others.
- Compare by a field. Remove duplicates after merge compares whole items. To treat items with the same
idas duplicates, follow Merge Lists with Remove Duplicates. - Gather single results. To gather single results from several nodes, rather than lists, use Collect.
Frequently asked questions
Related
Remove Duplicates
Collect
List
Extract Field
Lists and batching
Last updated on
Remove Duplicates
Remove repeated items from a list and keep the first copy of each. Compare whole items or one field, such as id or url, in scraped or merged lists.
Choose Best
Turn many results into one. An AI judge picks the best image or text against your criteria, or the node joins, counts, votes on or merges the results.