> For the complete documentation index, see [llms.txt](https://dataqueue.gitbook.io/voicehub-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dataqueue.gitbook.io/voicehub-docs/agent-design-and-usage/custom_analysis_fields.md).

# Custom Analysis Fields

Custom Analysis Fields allow you to extract additional insights from calls by defining your own metrics. These fields can be configured in both **Calls** and **Call Studio**, and can be exported/imported via JSON so they can be shared across agents.

You can use them to track things like:

* Whether the **issue was resolved**
* Which **product was mentioned**
* Other conversation insights specific to your workflow

## Creating a Custom Field

Custom fields can be configured in **Call Analysis settings** or **Call Studio Analysis settings**.

Each field requires three properties:

| Field           | Description                                                                                |
| --------------- | ------------------------------------------------------------------------------------------ |
| **Name**        | The unique name of the field                                                               |
| **Description** | Instructions describing what the system should determine from the conversation             |
| **Type**        | The type of value the field returns (The supported types are string, number, and Boolean). |

#### Example

<figure><picture><source srcset="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FkyfW3yW609FfrmFSCkgG%2Fcustom%20fields%20dark.png?alt=media&amp;token=7731fb89-be7c-44ec-939c-02f16f877a18" media="(prefers-color-scheme: dark)"><img src="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2Fzx8U9oRZ039GMuuWC8BV%2Fimage.png?alt=media&amp;token=66025f4c-78fb-43e3-a065-6b0388cba71f" alt=""></picture><figcaption></figcaption></figure>

## Viewing Custom Fields in Call Analysis

Custom fields appear in the **Call Analysis modal** for each call or call studio record.

For every field you will see:

* Field name
* Calculated value

<figure><picture><source srcset="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FMhqhQETILzAiaIkwI25d%2Fimage%20(1).png?alt=media&amp;token=d53f5d63-a003-439c-8c04-544ae3ca158e" media="(prefers-color-scheme: dark)"><img src="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2FW2cjjpqJY9a5rpt17cZC%2Fimage.png?alt=media&amp;token=16e7ace1-052c-4bdb-9aba-a1d0745bed16" alt=""></picture><figcaption></figcaption></figure>

## Viewing Custom Fields in Dashboard

The custom fields visualizations appears in C**alls Live Data** and in C**all Studio Live Data** under analysis factors fields accordion.

<figure><picture><source srcset="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2F5E9mwuH5XbZdeE86Ggrw%2Fcustom%20fields%20dashboard%20dark.png?alt=media&amp;token=292ed056-50fd-4909-a85d-675e727cd7ab" media="(prefers-color-scheme: dark)"><img src="https://1583580785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVRUgVLmtuyNEZUgZ8LYH%2Fuploads%2Fd4VzqE9iQzn7ybgOBIyk%2Fimage.png?alt=media&amp;token=7acb10ab-e6d9-4491-bf3b-cd3911ff7fd0" alt=""></picture><figcaption></figcaption></figure>
