---
title: "Using the Mapping Step"
slug: "using-mapping-step"
tags: ["object ", "Mapping"]
updated: 2025-06-18T14:33:40Z
published: 2025-06-18T14:33:40Z
---

> ## 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 the Mapping Step

## Overview

The **Mapping****step** lets users map data from one object into another. For example, if a Flow contains empty objects and a user wants to populate attributes to those objects, the Mapping step could be used. The Mapping step is best used when affecting multiple objects or multiple attributes of an object.

---

## Example

1. In a Project, click CREATE FLOW****and create a new [Flow](/v9/docs/creating-your-first-flow-2).
2. Click SETUP INPUT DATA and click **DEFINE**. Enter "File" under NAME and select **File Data** from the TYPE dropdown menu. Click **Save**and close the window.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1736368510917.png)
3. Attach a **Create Data** step from the **T****oolbox**panel under the FAVORITE STEPS category to the **Done**path of the **Start**step. On the **Properties**panel, click SHOW EDITOR.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750256732086.png)
4. In the **Data to Create** window, enter "NewFileName" under NAME and leave the TYPE as **String [Text]**. Define the Value if Null as "UPDATEDFileName". Click Save and close the window.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1736368638633.png)
5. Attach a **Mapping****step**from the DATA category to the Done path of the Create Data step. On the Properties panel, click **Unknown**next to the **File**field and select **Build Data**. Set the mapping for the **FileName**value to **Flow Data** and select **NewFileName**. Click DONE.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750257107326.png)If using a database structure, add an Edit/Save step after the Mapping Step. This will ensure that changes are saved to the database. Without adding this step, the changes will only be done in memory and not in the database.
6. Connect the Done path to the **End**step. Click Save to save changes to the Flow.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750257137997.png)

---

## Debug

1. Click **Debug**from the top action bar.
2. Click START DEBUGGING.
3. After the Flow runs, select the Mapping step, select **Execution 1**, and select **View Input/Output Data**.When the Flow executes then the mapping step will change the FileName of the existing File.

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

---

## Feature Changes

| Description | Version | Release Date | Developer Task |
| --- | --- | --- | --- |
| Updated the UI for Data Designer. | [9.6](https://documentation.decisions.com/v99/docs/version-96x-release-notes) | January 2025 | [DT-042522] |

---

For further information on Flows, visit the [Decisions Forum](https://community.decisions.com/categories/Flows).