> 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/list-columns.md).

# List columns

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

List columns determine which data is shown in the case list of a case group. Each column has one path per case definition in the group, so the same column can show data that is stored in a different place in each case definition.

***

## Configuring list columns

{% 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 **List columns** tab
{% endstep %}
{% endstepper %}

The list shows all columns with their name, key, display type, and whether they are sortable. Click the arrow in front of a column to see its 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-fb3c5d70e0e680eb45d7930daac5f09775e30d05%2F07-list-column-path-mappings.png?alt=media" alt=""><figcaption><p>List columns with path mappings</p></figcaption></figure>

{% hint style="info" %}
The **Add** button is disabled until the case group contains at least one case definition. Add case definitions first on the [General](https://docs.valtimo.nl/configuration-guides/cases/case-groups/configuration.md#adding-case-definitions) tab.
{% endhint %}

### Creating a column

{% 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, either by selecting it from the dropdown or by typing it after switching the toggle from **Dropdown** to **Manual**

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

{% step %}
Select a display type
{% endstep %}

{% step %}
Optionally, select the sorting options
{% endstep %}

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

#### Column properties

| Property                   | Description                                                                                                                                                                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Title                      | Column header shown in the case list                                                                                                                                                                                                                               |
| Key                        | Unique identifier of the column within the group. Generated from the title.                                                                                                                                                                                        |
| Path (per case definition) | Path to the value for each case definition, for example `doc:achternaam` or `case:createdOn`. Use **Filter case definitions...** and **Show only missing paths** to find case definitions without a path. The counter shows how many case definitions have a path. |
| Display type               | How the value is shown: text, date, boolean, enum, or tags. Date and tags have extra options for the date format and the number of tags shown.                                                                                                                     |
| Sortable                   | Whether users can sort the case list on this column                                                                                                                                                                                                                |
| Default sort (optional)    | Sort direction used when the case list opens. Only one column can have a default sort.                                                                                                                                                                             |

#### Path prefixes

| Prefix  | Description                | Example                                   |
| ------- | -------------------------- | ----------------------------------------- |
| `doc:`  | Field in the case document | `doc:aanvrager.naam`                      |
| `case:` | Case property              | `case:createdOn`, `case:assigneeFullName` |

#### Sortable columns

A column can only be made sortable when every case definition uses the **same case property** as path. These case properties can be sorted on:

`case:createdOn`, `case:modifiedOn`, `case:createdBy`, `case:sequence`, `case:retentionDate`, `case:assigneeId`, `case:assigneeFullName`, `case:internalStatus`, and `case:documentDefinitionId.name`.

Columns that use document fields (`doc:`) cannot be sorted, because the field differs per case definition.

### Editing or deleting a column

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

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

### Reordering columns

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