---
title: "Zip"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/control/zip
markdown: https://docs.nodetool.ai/nodes/nodetool/control/zip.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/control/zip.md
---

# Zip

**Type:** `nodetool.control.Zip`

**Namespace:** `nodetool.control`

## Description

Pair items from two independent iteration sources by matched index within the common parent.
    zip, pair, combine, merge, join, index, stream, iterate

    Use cases:
    - Combine matching items from two parallel streams
    - Pair inputs and outputs by position
    - Merge two iteration sources into tuples

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| left | `any` | Left iteration source. | null |
| right | `any` | Right iteration source. | null |
| max_unmatched_pairs | `int` | Maximum number of unmatched items to buffer before failing. §7. | `1024` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| left | `any` |  |
| right | `any` |  |
| index | `int` |  |

## Related Nodes

Browse other nodes in the [nodetool.control](./) namespace.