# Working with field tags

## Introduction

To access field tags, edit an endpoint for your connector and select the `schema/taxonomy` tab - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FPcowIEARcPajxFnNUgaW%2Ftags%201.png?alt=media&#x26;token=1983a4c6-b01b-4e2e-8b18-ea8ca2cc8cf9" alt=""><figcaption></figcaption></figure></div>

* [Add a new field tag ](#adding-a-new-field-tag)
* [Change an existing field tag](#changing-an-existing-field-tag)
* [Remove a field tag](#removing-an-existing-field-tag)

## Adding a new field tag

Follow the steps below to add a new field tag for your schema.

{% stepper %}
{% step %}
**Add a new tag**

Click the `add new tag` button:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FmbnpsT2UV5jlDhOLHpyt%2Fadd%20tag%201a.png?alt=media&#x26;token=1d98ebe7-9b29-452e-aec9-a511b510d868" alt=""><figcaption></figcaption></figure></div>

...the `edit field tags` modal is displayed:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FxsBoTyIx61ztDB5Q8YYt%2Fadd%20tag%201b.png?alt=media&#x26;token=a2b9bddb-9b0c-4b69-9d16-31ba04e2d4fe" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Choose which field to tag**

Select the required field from your schema, using the field dropdown list, for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FdL93y6cIWyll0OGNwYfO%2Fadd%20tag%201c.png?alt=media&#x26;token=33da7610-e103-498f-8d44-25f32665fd93" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
All data fields found in the [schema](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/schema-taxonomy) associated with this endpoint are available for selection.
{% endhint %}
{% endstep %}

{% step %}
**Choose a field tag**

Click in the `select tags` field and find a tag to apply from the Patchworks field tag taxonomy- for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FpIKoNxR3SCRDCdyCAoQi%2Fadd%20tag%201d.png?alt=media&#x26;token=e4b2359f-79df-4b54-a885-8c5712b1c6f7" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Tags are organised by entity - `customer` tags, `location` tags, `shipping address` tags, `orders` tags, etc.
{% endhint %}
{% endstep %}

{% step %}
**Save the tag**

Click anywhere outside of the list of tags to confirm your selection, then click the `save tags` button to confirm your selections.

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FKXHZiCdcDPYS9kBSmuJ0%2Fadd%20tag%201f.png?alt=media&#x26;token=cd349cba-8f65-45eb-a5b7-a7a0cbee3f77" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
The `tracked fields` option is now deprecated. Fields can now be tracked via the [track data](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/track-data-shape) shape.
{% endhint %}
{% endstep %}
{% endstepper %}

## Changing an existing field tag

Follow the steps below to update an existing field tag for your schema.

{% stepper %}
{% step %}
**Access the tag to be changed**

Click on an existing tag that you want to change, for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F8uUD6JOx39TdPUSIWboJ%2Fchange%20tag%201.png?alt=media&#x26;token=b95072da-d9f1-449e-a2c3-4b05555ed656" alt=""><figcaption></figcaption></figure></div>

The `edit field tags` modal is displayed, and any existing tags are shown - for example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FfnMeK1cJnmmX6CorfA3W%2Fchange%20tag%202.png?alt=media&#x26;token=6accd45e-2b83-4607-8702-690e567b7ef1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Access the tag to be changed**

Click the 'cross' icon associated with the tag you want to change, for example:&#x20;

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F2zuq37Eil00ICPseR4gw%2Fchange%20tag%203.png?alt=media&#x26;token=ff235f2f-4c6f-4bac-a4d0-721d41a39550" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
You can associate multiple tags with any given field, so you don't have to remove an existing tag unless you need to.&#x20;
{% endhint %}
{% endstep %}

{% step %}
**Add the replacement tag**

Click in the `select tags` field to find a replacement tag from the Patchworks field tag taxonomy, for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FuhSFrK2zGpvWE5IKrfW2%2Fchange%20tag%205.png?alt=media&#x26;token=b7b4d7b6-0577-49c0-8cea-61f94011725f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Save the tag**

Click the `save tags` button to confirm your selections.
{% endstep %}
{% endstepper %}

## Removing an existing field tag

Follow the steps below to remove an existing tag for your schema..

{% stepper %}
{% step %}
**Access the tag to be removed**

Click on an existing tag that you want to remove, for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fsv33Isrvjir8V1uZoD8D%2Fremove%20tag%201.png?alt=media&#x26;token=300a7946-2093-4512-9619-56cd64a37849" alt=""><figcaption></figcaption></figure></div>

The `edit field tags` modal is displayed, and any existing tags are shown, for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FhLq4bD2bsD9GrIOUHbcs%2Fremove%20tag%201a.png?alt=media&#x26;token=feb9519b-1a6d-41c2-ac49-dcb1c828f5b2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Remove tag(s) for the selected field**

Click the 'cross' icon associated with any tags you want to remove, for example:&#x20;

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FKRJYqTegNWOjF5qvESGs%2Fremove%20tag%202.png?alt=media&#x26;token=07612cbd-d128-4753-a510-a7c23f95eaa7" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

{% endstep %}
{% endstepper %}

## What if there's no field tag for a field in my schema?

Don't worry! The point of field tagging is that we tag the most common fields that Patchworks has identified. If your data schema includes fields where none of our tags apply, there's no need to tag it.
