> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations.md).

# Working with field transformations

## Introduction

**Field transformations** can be defined to change the value of a data field pulled from a source system before it is sent to its target. A **transformation** is comprised of one or more [functions](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations/available-transform-functions.md).

This page explains how to [add a new transformation](#adding-a-new-transformation) for a field mapping, and [how to remove functions and transformations](#deleting-an-existing-function-or-transformation).

{% hint style="info" %}
For a summary of available transform functions please see the [Field mapping transformation function reference](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations/available-transform-functions.md) section.
{% endhint %}

{% hint style="info" %}
For information about adding a field transformation using a cross-reference lookup table, please see our [cross-reference lookups](/product-documentation/process-flows/cross-reference-lookups.md) section.
{% endhint %}

## Adding a new transformation

To add a new transformation for a field mapping, you start by adding a new transformation and then build the required functions. To do this, follow the steps below:

**Step 1**\
Access the required process flow and then edit the map shape to be updated with a transform:

<div align="left"><figure><img src="/files/rJhAeNnTcpbXk92Kladq" alt="" width="317"><figcaption></figcaption></figure></div>

**Step 2**\
Find the mapping that you want to update, then click the **transform** icon (between source and target elements). For our example, we're going to add a prefix to the 'id' field:

<div align="left"><figure><img src="/files/Zm1Qp34T5W6WOLHVluAv" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 3**\
Click the **add transform** button:

<div align="left"><figure><img src="/files/kInd0PcWadGk9qhkyTQq" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 4**\
Use the **select a function** field to choose the type of function that you need to use (functions are organised by type):

<div align="left"><figure><img src="/files/1WWslfi9NASr13wvlgUL" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 5**\
Depending on the type of function you select, additional fields are displayed for you to complete. Update these as required - for our example we're adding some text to be added as a prefix:

<div align="left"><figure><img src="/files/81rx887htOs34amycc84" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 6**\
Now we need to confirm which source field this transform field should be applied for - click the **add field** button:

<div align="left"><figure><img src="/files/tKcQsPMHT2GbNy7TbAnL" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 7**\
Select the required field:

<div align="left"><figure><img src="/files/k5HxhMKPoHRBQmOXMgqz" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
In straightforward scenarios, this will typically be the same source field as defined for the mapping row. However, more complex scenarios may prompt multiple options here - for example, if you apply multiple transforms to the same mapping.
{% endhint %}

**Step 8**\
Accept your changes.

**Step 9**\
Add more fields if necessary.

**Step 10**\
When you're satisfied that all required fields have been added, accept changes and then save the shape settings.