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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.