> 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-details/statuses.md).

# Statuses

The Statuses sub-tab manages the internal status labels that can be assigned to cases of this type. Statuses are shown on the case detail page and can be used to filter the case list.

Each status has a name, a color, and an optional retention period that determines when cases with that status are automatically deleted.

{% hint style="warning" %}
Statuses apply to **all versions** of the case type, not just the version you're currently viewing. Updating a status changes it everywhere the case type is used.
{% endhint %}

***

## Configuring statuses

{% 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 details** tab, then the **Statuses** sub-tab

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-0767756f416832e21052fc9c452f136cf49f44e2%2F01-statuses-list.png?alt=media" alt=""><figcaption><p>Statuses list</p></figcaption></figure>
{% endstep %}
{% endstepper %}

The list shows every configured status with its name, key, default visibility, retention period, and color. Drag a row by its handle to reorder statuses.

### Creating a status

{% stepper %}
{% step %}
Click **Create status**
{% endstep %}

{% step %}
Fill in the status details:

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-e2d0b60b0a9574b6ff27b8763178126e76c6a47f%2F02-create-status-modal-empty.png?alt=media" alt=""><figcaption><p>Create status modal</p></figcaption></figure>

| Property                        | Description                                                                                                                      |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Status name                     | Display name for the status. The **Status key** is generated from this automatically; click the pencil icon to edit it manually. |
| Label (Optional)                | Alternate text shown instead of the status name, if needed                                                                       |
| Color                           | Tag color used to display the status                                                                                             |
| Default visibility in case list | Whether cases with this status are shown in the case list by default                                                             |
| Set retention period            | Enables the **Retention period in days** field                                                                                   |

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-3311469aa55037f885bd24f01466f8e7eb50caad%2F03-create-status-modal-filled.png?alt=media" alt=""><figcaption><p>Create status modal with retention</p></figcaption></figure>

| Retention period in days | Effect                                                                        |
| ------------------------ | ----------------------------------------------------------------------------- |
| `0` or higher            | The case is automatically deleted this many days after reaching the status    |
| `-1` (default)           | No retention period — the case is never automatically deleted for this status |
| {% endstep %}            |                                                                               |

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

{% hint style="info" %}
Changing the retention period on an existing status does not retroactively update cases that already have that status.
{% endhint %}

### Editing or deleting a status

{% stepper %}
{% step %}
Click a row, or use its overflow menu (⋮), to **Edit** or **Delete** a status

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-fa1f88c9462033f09d38f077b009fc6f7af9c870%2F04-row-overflow-menu.png?alt=media" alt=""><figcaption><p>Row overflow menu</p></figcaption></figure>
{% endstep %}

{% step %}
Deleting a status requires confirmation:

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-cf4bf7f43122cada9b2899fe146d0376ac1b3c8d%2F05-delete-confirmation-modal.png?alt=media" alt=""><figcaption><p>Delete confirmation modal</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Deleting a status cannot be undone. Cases already assigned that status keep it as an unrecognized value.
{% endhint %}