---
title: "Create widget group"
manual: "Dashboard"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-dashboard:create-widget-group@main"
source: "Configuration/WidgetGroupCreation.rst"
rendered: "2026-09-30T05:15:21+00:00"
---

# Create widget group {#create-widget-group}

Widget groups are used to group widgets into tabs.
This will have an effect when adding new widgets to an dashboard.
See [Adding Widgets](https://docs.typo3.org/permalink/typo3/cms-dashboard:adding-widgets@main) to get an idea of the UI.

Groups are defined as PHP array:

**Example from EXT:dashboard/Configuration/Backend/DashboardWidgetGroups.php**

```php
<?php

return [
    'general' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widget_group.general',
    ],
    'systemInfo' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widget_group.system',
    ],
    'typo3' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widget_group.typo3',
    ],
    'news' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widget_group.news',
    ],
    'documentation' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widget_group.documentation',
    ],
];
```

The file has to return an array of groups.
Each group consists of an array key used as identifier and an single option `title`.
The title will be processed through translation and can be an `LLL` reference.

Each extension can create arbitrary widget groups.

Widgets can be assigned to multiple groups using the [groupNames](https://docs.typo3.org/permalink/typo3/cms-dashboard:confval-widget-tag-groupnames@main).
Please read [Register new Widget](https://docs.typo3.org/permalink/typo3/cms-dashboard:register-new-widget@main) to understand how this is done.