> 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/patchworks-services/working-with-services/adding-a-patchworks-service/define-field-mappings.md).

# Define field mappings

## Introduction

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

<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="/pages/kxD2tYMum1HQudXgmx9h">Add a default service</a></td></tr><tr><td>2</td><td><a href="/pages/v5rGyrnZ8XdIXknu01sQ">Configure service settings</a></td></tr><tr><td>3</td><td><a href="/pages/agWE3KxDTdALMJ1gDMLm">Set the service trigger schedule</a></td></tr><tr><td>4</td><td><a href="/pages/b7OSm5jkuCB96nnr53ql">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="/pages/DQBxm4WsA8V980mvpSOa">Activate the service</a></td></tr></tbody></table>

## Prerequisites

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

<figure><img src="/files/CUNJmG82AnQ4i45jYBXl" 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:\
\
![](/files/bZIS6wyji6hxG0dyv6RH)

</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="/files/hnAO8i9gMjVGuwPfRp7n" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/qOzeFIlj8lhM5iWSduSz" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/H2wisdARvnBbz6Mz1M3k" 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="/files/hpVCDGK9MN9xuTKY0n9F" 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](/product-documentation/patchworks-services/working-with-services/field-mappings-and-transformations-services/field-mappings-services.md).
{% endhint %}