> ## Documentation Index
> Fetch the complete documentation index at: https://learn.workflow.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Zip Lists

> Combine matching positions from multiple lists.

**Zip Lists** groups the first item from every input list, then the second item
from every list, and so on. The result is as long as the longest input; missing
positions become `null`.

## Inputs

| Input                           | Type            | Required | Description                                 |
| ------------------------------- | --------------- | -------- | ------------------------------------------- |
| **Name Lists with Object Keys** | Boolean         | No       | Return objects instead of positional lists. |
| **Lists**                       | Repeatable list | No       | Lists to combine. Starts with two slots.    |

When naming is enabled, every list entry has a **Key** and **List** input. Each
output item is an object whose properties use those keys.

## Output

| Output     | Type | Description                             |
| ---------- | ---- | --------------------------------------- |
| **Zipped** | List | Positionally combined lists or objects. |

<Tabs>
  <Tab title="Positional">
    Zipping `[1, 2]` and `["a"]` returns `[[1, "a"], [2, null]]`.
  </Tab>

  <Tab title="Named">
    Naming the same lists `id` and `label` returns
    `[{"id": 1, "label": "a"}, {"id": 2, "label": null}]`.
  </Tab>
</Tabs>

<Warning>
  Toggling **Name Lists with Object Keys** replaces the list-input shape and
  changes each output item from a list to an object. Check downstream
  connections after changing it.
</Warning>