---
title: "Using List Mapping Step"
slug: "mapping-step-and-list-mapping-step"
updated: 2026-06-26T13:47:38Z
published: 2026-06-26T13:47:38Z
canonical: "documentation.decisions.com/mapping-step-and-list-mapping-step"
---

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

# Using List Mapping Step

## Overview

The **List Mapping Step** allows users to change a list from one type of structure into a different one. This is helpful with API calls because it can change the XML, JSON, or other list types into a different structure.

| **Properties** | Description |
| --- | --- |
| INPUTS | Takes in a list of user-defined types or primitive types |
| Output Type | The type of INPUTS will be changed to |
| Show Item Mapping Editor | The mapping editor to map the desired data fields from the **INPUTS** type to the **Output** Type |

The following example can be imported into Decisions.  
[ElementRegistration__[ac63cada865d11eb894d00155d0af02e]__UsingListMappingStep.decObj](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/ElementRegistration__%5Bac63cada865d11eb894d00155d0af02e%5D__UsingListMappingStep.decObj)

---

## Example

1. In a Designer Project, click CREATE FLOW from the **Global Action Bar** and select **Flow**. Name the Flow and click CREATE.
2. Attach the **Fetch** **Entities** step from the FAVORITE STEPS category of the **Toolbox** panel to the **Start** step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778695376240.png)
3. On the **Properties** panel under the ENTITY FETCH DEFINITION category. Enter "account" in the **Type Name** field and select **Account** from the dropdown menu.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778696057438.png)
4. Attach a **List Mapping Step** from the **Toolbox** panel under the DATA > LIST category to the **Results** path of the Fetch Entities step and the **End** step. Connect the **No** **Results** path to the End step. On the Properties panel, select the desired Data Structure from under the Output Type field. Map **EntityResults** to INPUTS and click **Show Item Mapping Editor**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778696179511.png)
5. From the **Mapping** **Editor**, set ITEM to **Build** **Data**. From **_INPUT**, map **AccountID** to ID **Value** and **EmailAddress** to Email Address. Click OK. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778696605435.png)
6. Click **Save** to save changes to the Flow.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778696632490.png)

---

## Debug

1. Click **Debug** from the top action bar.
2. Click START DEBUGGING.
3. After the debugger runs, click the List Mapping Step, select **Execution 1**, and select **View Output Data**. The resulting data will display as a list mapped in accordance with the selected Output Data Type.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778696710280.png)