# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/patchworks-services/working-with-services/adding-a-patchworks-service/define-field-mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.