# Required fields are not being tracked

## Scenario

When checking the [tracked fields panel on the process flow overview page](/product-documentation/process-flows/the-process-flows-overview-page.md), fields that you expect/want to see are not shown.

## Reason

When connector endpoints are configured, fields in the associated data schema can be flagged as **tracked**. By tracking these fields, they become available for viewing/filtering/selecting wherever tracked data is shown in Patchworks.

If you are not seeing a required field in the tracked fields panel, it's likely that it has not been flagged for tracking in the connector setup.

## Solution

{% hint style="warning" %}
The steps below involve updating connector settings. Updating settings for a connector may affect how the connector runs. Please check with Patchworks support if you need to update tracked fields but are not sure about making this change.
{% endhint %}

### **Stage 1: check tracked fields for the connector**

The first thing to do is access connector settings and check which fields have been flagged for tracking. To do this, follow the steps below.

**Step 1**\
Select **connectors & instances** from the dashboard navigation menu - all installed connectors for your company profile are displayed.

**Step 2**\
Access settings for the connector that you want to update.

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

**Step 3**\
Select the **endpoints** option:

<div align="left"><figure><img src="/files/8w3FeUkzpc5ODFdtclRB" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 4**\
Click the name of the first endpoint that you want to update to access its settings.

{% hint style="info" %}
Most connectors will have multiple endpoints - you will need to update all endpoints that you use (or are likely to use) in process flows.
{% endhint %}

**Step 5**\
Select the **schema/taxonomy** tab:

<div align="left"><figure><img src="/files/CStHOsDjf7H3cf4PkEZL" alt=""><figcaption></figcaption></figure></div>

**Step 6**\
Check the **tags** panel on the right-hand side of the page. Here you'll see a list of fields (from the associated data schema) which have been tagged and - if applicable - set to be tracked:

<div align="left"><figure><img src="/files/Zkc51xB5HwSkMVyKNxqe" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
It's possible that lots of fields will be tagged but not flagged for tracking. Look for a tick in the **tracked** column to see where tracking is enabled.
{% endhint %}

The next steps depend upon what you see here:

| What you see in the tags panel                                                    | Action                                                                                                                                                    |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| My query field is NOT shown in the tags list                                      | See [stage 2](#stage-2-update-field-tag-information) to tag the field and flag for tracking                                                               |
| My query field IS shown in the tags list but the **tracked** column is NOT ticked | See [stage 2](#stage-2-update-field-tag-information) to edit tag details and flag for tracking                                                            |
| My query field IS shown in the tags list and the **tracked** column IS ticked     | Your configuration appears to be correct. Please [contact Patchworks support](/product-documentation/raising-a-support-ticket.md) for further assistance. |

### Stage 2: Update field tag information&#x20;

Your next steps will depend on the outcome of your checks at the end of [stage 1](#stage-1-check-tracked-fields-for-the-connector) - please expand the appropriate instructions below:

<details>

<summary>My query field does NOT show in the tags panel</summary>

If your query field does not show in the **tags** panel, follow the steps below to add a new tag and flag the field for tracking.

**Step 1**\
Click the add a new tag button:

<img src="/files/RqbyCPE2nSxMm3xqOjnW" alt="" data-size="original">

**Step 2**\
Navigate the **field** data schema to find and select your query field:

<img src="/files/CQMG0h06arxqDcpLT0BY" alt="" data-size="original">

**Step 3**\
Click in the field below to see a list of standard Patchworks tags, then navigate this list to find a suitable tag for your field:

<img src="/files/ApTIl8bd9UTieucKEhHE" alt="" data-size="original">

These tags are used in [field mappings](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape.md) - what you choose now isn't critical but it can help make mapping more efficient in future. Please see our [field tagging ](/product-documentation/developer-hub/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/schema-taxonomy/field-tagging.md)page for more information.

**Step 4**\
Select the **tracked** checkbox so that it's enabled:

<img src="/files/xTXdHRtoXdkIuq9I7yvH" alt="" data-size="original">

**Step 5**\
Save changes:

<img src="/files/WAoVtop4O8L1DahfKTje" alt="" data-size="original">

</details>

<details>

<summary>My query field DOES show in the tags panel but without a tracked tick</summary>

If your query field DOES show in the **tags** panel but the **tracked** column is not ticked, follow the steps below to set field tracking.

**Step 1**\
Click the tag that you need to update:

<img src="/files/Tt72HOZCrIlVsyQt9c9z" alt="" data-size="original">

**Step 2**\
Select the **tracked** checkbox so that it's enabled:

<img src="/files/U0mAgNFy8aUMl5XHcD3a" alt="" data-size="original">

**Step 3**\
Save changes:

<img src="/files/s6L6CSWnhh4ffoUNEvxi" alt="" data-size="original">

</details>

{% hint style="info" %}
Most connectors will have multiple endpoints - you will need to update all endpoints that you use (or are likely to use) in process flows.
{% endhint %}

## Further information

For more information please see the following pages:

* [About tracked fields](/product-documentation/process-flows/the-process-flows-overview-page.md#about-tracked-fields)
* [Field tagging (connector builder)](/product-documentation/developer-hub/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/schema-taxonomy/field-tagging.md)


---

# 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/process-flows/troubleshooting-process-flows/required-fields-are-not-being-tracked.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.