# Define field mappings

## Introduction

This page is **part 5** of the instruction set for [adding a Patchworks service](https://doc.wearepatchworks.com/product-documentation/patchworks-services/working-with-services/adding-a-patchworks-service):

<table><thead><tr><th width="221.5">Part #</th><th width="249.5">Link to instructions</th></tr></thead><tbody><tr><td>1</td><td><a href="add-a-default-service">Add a default service</a></td></tr><tr><td>2</td><td><a href="configure-service-settings">Configure service settings</a></td></tr><tr><td>3</td><td><a href="set-the-service-trigger-schedule">Set the service trigger schedule</a></td></tr><tr><td>4</td><td><a href="define-service-filters">Define service filters</a></td></tr><tr><td><strong>5</strong></td><td>Define field mappings</td></tr><tr><td>6</td><td><a href="activate-the-service">Activate the service</a></td></tr></tbody></table>

## Prerequisites

The steps detailed on this page assume that you are following the ['new service' flow](https://doc.wearepatchworks.com/product-documentation/patchworks-services/working-with-services/adding-a-patchworks-service) and have just saved the service [filter options](https://doc.wearepatchworks.com/product-documentation/patchworks-services/working-with-services/adding-a-patchworks-service/define-service-filters), so the **field mapping** page is displayed with mappings organised in logical categories:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/8e9TiNrSRmGfzlNQ8AVy/field%20mapping%20page.png" alt=""><figcaption></figcaption></figure>

<details>

<summary>I've exited from the 'new service' flow - how do I get to this page now?</summary>

If you have exited the 'new service' flow and need to get back to this point, you can access all service configuration options via the **canvas** tab:\
\
![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/EKVEkHZb6hLPfNMlyl3v/service%20canvas%20journey%20NEW%202.png)

</details>

## The steps

Follow the steps below to define your fields mappings:

**Step 1**\
To view details for a mapping entry, click anywhere in a row to expand details:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/rXNHKIBEx8OOkDteZAza/view%20field%20mapping%20details.png" alt=""><figcaption></figcaption></figure>

**Step 2**\
To edit mapping details for an entry, click the **edit** button in detail view:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/S3eZMvxwoo1YWlATkksv/edit%20mapping%20option.png" alt=""><figcaption></figcaption></figure>

...the mapping is opened in edit mode and you can make changes as required:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/aYgGFUGT894Bv1FOywqG/edit%20field%20mapping%202.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If a mapping row is marked with a red star, it means that at least one half of the mapping is locked for editing because the values are expected by Patchworks.
{% endhint %}

**Step 3**\
To remove a mapping entry, click the **trash** icon in detail view:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/SwG0kGNCR9UjRaDtwF6O/remove%20mapping.png" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
This option is not available for mapping entries marked with a red star (i.e. entries which are required by Patchworks).
{% endhint %}

**Step 4**\
Having made all required updates, click the **next** button. Mappings are saved and **field mappings** are displayed.

{% hint style="info" %}
For more information about working with mappings, please see the [field mappings page](https://doc.wearepatchworks.com/product-documentation/patchworks-services/working-with-services/field-mappings-and-transformations-services/field-mappings-services).
{% endhint %}