---
hide_title: true
hide_table_of_contents: true
title: Array Map
---

<##head##>

# Array Map

This node takes an input array, runs a small map script on each item, and outputs the resulting mapped array. That is an array with new objects, each created in the mapping script.

<div className="ndl-image-with-background l">

![](/nodes/data/array/array-map/array-map.png)

</div>

<##head##>

## Inputs

| Data                                    | Description                                                  |
| --------------------------------------- | ------------------------------------------------------------ |
| <span className="ndl-data">Items</span> | <##input:items##>The array that should be mapped.<##input##> |

### Script

The mapping script used to map the objects in the input array to new objects in the mapped output array. The script should be provided in the following format:

```javascript
map({
    FullName: () => object.first_name + object.last_name,
    Age: 'years_old',
})
```

You can either provide a string with the name of the property that should be mapped with the syntax _to:'from'_ which will simply rename a property taking the value directly from the input object. Or you can provide a mapping function that takes the object (of the type [Noodl.Object](/javascript/reference/object)) and the function should return the mapped value.

Sometimes you need to extract the **Id** of the objects you are mapping, this can be done in the following way:

```javascript
map({
    Value: () => object.getId(),
    Label: 'PhotoName',
})
```

Note that the objects that are created when mapping are new objects so they will have their own Id as well.

## Outputs

### General

| Data                                    | Description                                                                                                      |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <span className="ndl-data">Items</span> | <##output:items##>The mapped array.<##output##>                                                                  |
| <span className="ndl-data">Count</span> | <##output:count##>The number of items in the mapped array (this will be the same as the input array)<##output##> |

| Signal                                      | Description                                                                                                                                                                                  |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <span className="ndl-signal">Changed</span> | <##output:changed##>A signal is emitted here when the input array has been modified which will trigger the _Array Map_ node to remap the input and produce a new output _Items_.<##output##> |