> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/studio/tasks/reference/map/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# map

> Use the map task to map an input array to an array of values, producing key-value pairs.

The `map` task maps an input to an array of values.

## Potential use case

Suppose you have a list of data to input and you want to give each item in the list a numerical placement value. You could use the `map` task to accomplish this.

## Properties

| Incoming | Type  | Description                                                 |
| -------- | ----- | ----------------------------------------------------------- |
| `arr`    | Array | Required. The input array (objects or values) to be mapped. |
| `map`    | Array | Required. An array of values that will be used as the map.  |

| Outgoing | Type   | Description          |
| -------- | ------ | -------------------- |
| `result` | Object | The mapped `result`. |

## Example

In this example, the `arr` variable is `["a","b","c"]` and the values to `map` are the numerals `[1,2,3]`.

![](/_fern-img/0eccf8b920aeeec6eb5e1c1d2fc7ef313832cf460aa44b95ea69f6cd6f65f7b2.webp)

The `result` that returns is a list of key-value items shown as `["a": 1, "b": 2, "c": 3]`.

![](/_fern-img/bd1fe638d379a28faa4a19a5585cc91db388487140563db208ed7e76fb164da5.webp)

> Use the map task to map an input array to an array of values, producing key-value pairs.