# Create a Datastore Group

Source: https://userguide.qualytics.io/source-datastore/grouping/how-tos/create-a-group/

This guide walks you through the steps to create a new datastore group in Qualytics.

> **Note**
>
> You need the **Manager** role to create datastore groups. See the [Permissions](https://userguide.qualytics.io/source-datastore/grouping/deep-dive/permissions/) page for details.

## Group Fields

The **Create Group** dialog contains the following fields:

![create-group-fields](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/create-group-fields.png)

| REF. | FIELD | REQUIRED | DESCRIPTION |
| --- | --- | --- | --- |
| 1 | Name | Yes | A unique name for the group. Use at least 2 characters (up to 30), including at least one letter. Letters, digits, spaces, underscores, hyphens, and periods are allowed. Group names are case-insensitive, so `Production` and `production` are considered the same. If a group with the same name already exists, the creation fails with an error. |
| 2 | Icon | No | Select one icon from the predefined options to visually identify the group. Only one icon can be selected per group. Defaults to **Bookmark** if not specified. |

> **Info**
>
> When creating groups through the API, names can be up to 100 characters. The group creation form on this page keeps names to 30 characters so they fit inline in the group list and tree view. The same allowed-character and minimum-length rules apply to tag names.

### Available Icons

| No. | Icon | Label |
| --- | --- | --- |
| 1. |  | Bookmark (default) |
| 2. |  | Folder |
| 3. |  | Shape |
| 4. |  | Chart |
| 5. |  | Flask |
| 6. |  | Star |
| 7. |  | Texture |
| 8. |  | Bronze |
| 9. |  | Silver |
| 10. |  | Gold |

## Steps

**Step 1**: In the tree view header (top-left area of the sidebar), click the **Manage groups**  button.

![step-1-manage-groups-button](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/shared/step-1-manage-groups-button.png)

**Step 2**: The Manage Groups panel will open, showing existing groups or an empty state if no groups have been created yet.

![step-2-manage-groups-panel](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-2-manage-groups-panel.png)

**Step 3**: Click the **Create group**  button at the top of the panel.

![step-3-create-group-button](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-3-create-group-button.png)

**Step 4**: The **Create Group** dialog will appear. Enter a group name and select an icon as described in the [Group Fields](https://userguide.qualytics.io/source-datastore/grouping/how-tos/create-a-group/#group-fields) section above.

![step-4-create-group-dialog](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-4-create-group-dialog.png)

**Step 5**: Fill in the group name and select an icon. In this example, the group is named **Production Critical** with the **Star**  icon.

![step-5-fill-details](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-5-fill-details.png)

**Step 6**: Click the **Create** button to create the group.

![step-6-click-create](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-6-click-create.png)

**Step 7**: A success message will confirm that the group has been created. The new group will appear in the Manage Groups panel. Use the search field at the top of the panel to find groups quickly if you have many.

![step-7-group-created](https://userguide.qualytics.io/assets/source-datastores/grouping/how-tos/create-a-group/step-7-group-created.png)

> **Info**
>
> The newly created group will only appear in the tree view once a datastore is assigned to it. Until then, it is only visible in the Manage Groups panel. See the [Assign a Datastore to a Group](https://userguide.qualytics.io/source-datastore/grouping/how-tos/assign-a-datastore/) guide.

*Last updated: July 7, 2026.*