> For the complete documentation index, see [llms.txt](https://docs.valtimo.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valtimo.nl/configuration-guides/cases/case-groups/search-fields.md).

# Search fields

{% hint style="success" %}
Available since Valtimo `13.53.0`
{% endhint %}

Search fields determine which filters are available in the case list of a case group. Like list columns, each search field has one path per case definition, so one filter searches the right field in every case definition of the group.

***

## Configuring search fields

{% stepper %}
{% step %}
Expand **Admin** in the left sidebar
{% endstep %}

{% step %}
Click **Cases** under the Configuration section
{% endstep %}

{% step %}
Click the **Case groups** tab
{% endstep %}

{% step %}
Click a case group to open it
{% endstep %}

{% step %}
Click the **Search fields** tab

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-aef56eb2f88665fe9d1ca4a116c91cd715ae211a%2F08-search-fields.png?alt=media" alt=""><figcaption><p>Search fields</p></figcaption></figure>
{% endstep %}
{% endstepper %}

The list shows all search fields with their name, key, data type, field type, and match type. Click the arrow in front of a search field to see its path for each case definition.

### Creating a search field

{% stepper %}
{% step %}
Click **Add**
{% endstep %}

{% step %}
Fill in the title
{% endstep %}

{% step %}
Optionally, click the pencil icon to change the key that is generated from the title
{% endstep %}

{% step %}
Fill in a path for each case definition

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-a2737f5ce0ed936b3ea435bfef226d96b5cb9abe%2F09-add-search-field-modal.png?alt=media" alt=""><figcaption><p>Add search field</p></figcaption></figure>
{% endstep %}

{% step %}
Select the data type
{% endstep %}

{% step %}
Select the field type
{% endstep %}

{% step %}
Select the match type (new text fields start with **Contains**)
{% endstep %}

{% step %}
Click **Save**
{% endstep %}
{% endstepper %}

#### Search field properties

| Property                   | Description                                                                                                                                                                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Title                      | Label of the search field in the case list                                                                                                                                                                                                  |
| Key                        | Unique identifier of the search field within the group. Generated from the title.                                                                                                                                                           |
| Path (per case definition) | Path to the value to search on for each case definition. Only `doc:` and `case:` paths can be searched.                                                                                                                                     |
| Data type                  | Type of the value: text, number, date, datetime, or boolean                                                                                                                                                                                 |
| Field type                 | How the user enters the search value: single, range, single-select-dropdown, or multi-select-dropdown                                                                                                                                       |
| Match type                 | Required for the text data type with the single or range field type, and not shown otherwise. **Exact** finds only identical values; **Contains** also finds partial matches. Text fields saved earlier without a match type use **Exact**. |
| Dropdown data provider     | Optional. Source of the options for a dropdown field type.                                                                                                                                                                                  |

{% hint style="info" %}
Dropdown field types are only available for the text data type. The boolean data type only supports the single field type.
{% endhint %}

### Editing or deleting a search field

{% stepper %}
{% step %}
Click the overflow menu (**⋮**) of a search field
{% endstep %}

{% step %}
Select **Edit** or **Delete**
{% endstep %}
{% endstepper %}

### Reordering search fields

Drag the handle in front of a search field to change its position in the search panel of the case list. Reordering is not available while the search field above the list is in use.
