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

# List columns

List columns determine which data fields are visible in the end-user case list for a specific case type. Each column displays a value from the case document, case metadata, or linked zaak data, and can be configured with sorting and display options.

***

## Configuring list columns

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

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

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

{% step %}
Click the **Case list** tab, then the **List columns** sub-tab

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-f10b132ab9e8bb491b8a6c93a597b9e04d459f8d%2F02-list-columns-tab.png?alt=media" alt=""><figcaption><p>List columns configuration</p></figcaption></figure>
{% endstep %}
{% endstepper %}

The list shows all configured columns with their key, path, display type, and sorting options. Drag the handle on the left of each row to reorder columns.

### Creating a column

{% stepper %}
{% step %}
Click the **Create column** button
{% endstep %}

{% step %}
Fill in the column properties

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

{% step %}
Select a path from the dropdown to specify which data field to display
{% endstep %}

{% step %}
Select a display type

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-a8eb308140157dd2010d564eedcdeb95eab5dd19%2F04-display-type-dropdown.png?alt=media" alt=""><figcaption><p>Display type options</p></figcaption></figure>
{% endstep %}

{% step %}
Configure additional options (sortable, default sort, exportable)

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

{% step %}
Click **Create** to add the column
{% endstep %}
{% endstepper %}

#### Column properties

| Property     | Description                                                                              |
| ------------ | ---------------------------------------------------------------------------------------- |
| Title        | Optional display name for the column header. If not set, the key is used.                |
| Key          | Unique identifier for the column                                                         |
| Path         | Path to the data value (e.g., `doc:applicantName`, `case:createdOn`)                     |
| Display type | How the value is rendered in the list                                                    |
| Sortable     | Whether users can sort the list by this column                                           |
| Default sort | The default sort direction when the list loads (only one column can have a default sort) |
| Exportable   | Whether the column is included when exporting the case list                              |

#### Display types

| Type                  | Description                      | Additional parameters                      |
| --------------------- | -------------------------------- | ------------------------------------------ |
| Text                  | Plain text display               | None                                       |
| Date                  | Formatted date                   | Date format (optional, e.g., `DD-MM-YYYY`) |
| Yes/no                | Boolean display as Yes or No     | None                                       |
| Enumeration           | Maps values to display labels    | Key-value pairs for mapping                |
| Count                 | Shows the count of array items   | None                                       |
| Underscores to spaces | Replaces underscores with spaces | None                                       |
| Tags                  | Displays values as tags          | Tag amount (how many tags to show)         |

#### Path prefixes

| Prefix  | Description                 | Example                                   |
| ------- | --------------------------- | ----------------------------------------- |
| `doc:`  | Document (JSON) data fields | `doc:applicantName`                       |
| `case:` | Case metadata fields        | `case:createdOn`, `case:assigneeFullName` |
| `zaak:` | Linked zaak data (ZGW)      | `zaak:identificatie`                      |

### Editing a column

Click a column row to open the edit modal. Modify the properties and click **Save** to apply changes.

### Deleting a column

Click the overflow menu (three dots) on the right side of a column row and select **Delete**.

### Reordering columns

Drag the handle on the left side of each row to change the column order. The order in the configuration list matches the order in the end-user case list.

***

## JSON editor

Click the **JSON editor** button to view and edit the column configuration as JSON. This is useful for bulk changes or copying configurations between case types.

***

## Exporting configuration

Click the download button to export the current column configuration as a JSON file.