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

# General

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

The **General** tab of a case group defines which case definitions belong to the group and which color represents the group in the Cases overview and the left sidebar.

***

## Configuring general settings

{% 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 **General** tab

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-b1679377be46d0e6ad52cd370570c5cdb2a64f13%2F12-general-tab-overview.png?alt=media" alt=""><figcaption><p>General tab overview</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Creating a case group

{% 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 **Create**
{% endstep %}

{% step %}
Fill in the name and, optionally, a description

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

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

| Property    | Description                                                                     |
| ----------- | ------------------------------------------------------------------------------- |
| Name        | Display name of the case group. Required.                                       |
| Description | Short explanation shown on the case group tile in the Cases overview. Optional. |

The key of the case group is generated from the name (for example, `citizen_requests` for "Citizen requests") and cannot be changed.

### Editing a case group

{% stepper %}
{% step %}
Open the case group
{% endstep %}

{% step %}
Click **Edit** in the header
{% endstep %}

{% step %}
Change the name or description
{% endstep %}

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

***

## Choosing a group color

The **Group color** panel sets the color used for the case group tile in the Cases overview and for the dot in front of the pinned case group in the left sidebar.

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-24b52a76999fd241dfea7558ed500e110a8a0500%2F03-group-color.png?alt=media" alt=""><figcaption><p>Group color</p></figcaption></figure>

Click one of the predefined colors, or click the square next to **Choose your own color** to pick any color. The color is saved immediately and a confirmation appears.

Click **Remove color** to clear the color. The case group then shows the neutral gray dot again.

{% hint style="info" %}
Case definitions have a color of their own. It is set in the **Case color** panel on the [General](https://docs.valtimo.nl/configuration-guides/cases/general.md) tab of the case definition.
{% endhint %}

***

## Adding case definitions

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

{% step %}
Select a case definition

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

{% step %}
Click **Add to group**
{% endstep %}
{% endstepper %}

The table lists all case definitions in the group with their name and key. Use the **Filter case definitions...** field to search the table.

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-71f324c10e61451491f12a4acf33af39c4bdcb85%2F05-group-members.png?alt=media" alt=""><figcaption><p>Case definitions in a case group</p></figcaption></figure>

{% hint style="warning" %}
As long as no list columns are configured, the case group shows the warning **No list columns configured** and its case list shows no case data. Add list columns on the [List columns](https://docs.valtimo.nl/configuration-guides/cases/case-groups/list-columns.md) tab.
{% endhint %}

### Removing a case definition

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

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

The case definition is removed from the group immediately, without a confirmation. The case definition itself and its cases are not affected.

***

## Deleting a case group

{% stepper %}
{% step %}
Open the case group
{% endstep %}

{% step %}
Click **Delete** in the page header
{% endstep %}

{% step %}
Click **Delete** in the **Delete case group** dialog to confirm
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Deleting a case group cannot be undone. Its list columns, search fields and saved searches are removed, and it disappears from every user's pinned items. The case definitions in the group and their cases are not affected.

To keep a copy of the configuration, [export the case group](https://docs.valtimo.nl/configuration-guides/cases/case-groups.md#exporting-a-case-group) first.
{% endhint %}
