---
title: "Dashboard Presets"
manual: "Dashboard"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-dashboard:dashboard-presets@main"
source: "Configuration/WidgetPresets.rst"
rendered: "2026-09-30T05:15:21+00:00"
---

# Dashboard Presets {#dashboard-presets}

It is possible to configure presets of dashboards.
The extension already ships a `default` as well as an `empty` dashboard preset.

## Create preset {#create-preset}

New presets can be configured:

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

```php
<?php

return [
    'default' => [
        'title' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:dashboard.default',
        'description' => 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:dashboard.default.description',
        'iconIdentifier' => 'content-dashboard',
        'defaultWidgets' => [
            't3information',
            't3news',
            'docGettingStarted',
            [
                'identifier' => 'rss',
                'settings' => [
                    'label' => 'My RSS Feed',
                    'feedUrl' => 'https://typo3.org/rss',
                    'limit' => 10,
                ],
            ],
        ],
        'showInWizard' => false,
    ],
];
```

The file has to return an array with all presets.
Each prefix itself is an array, with an identifier as key.
The identifier is used to configure presets for users, see [Configure preset for user](https://docs.typo3.org/permalink/typo3/cms-dashboard:configure-preset-for-user@main).

Each preset consists of the following options:

-   **class DashboardPreset**

    -   *Fully qualified name:* `\TYPO3\CMS\Dashboard\DashboardPreset`

-   **title**

    -   *Type:* string

    The title used for the preset. E.g. a `LLL:EXT:` reference..

-   **description**

    -   *Type:* string

    The description used for the preset. E.g. a `LLL:EXT:` reference..

-   **iconIdentifier**

    -   *Type:* string

    The identifier of the icon to use.

-   **defaultWidgets**

    -   *Type:* array

    An array of widget identifiers, or fine-grained structure, that should be part of the dashboard preset.

    Widgets are always filtered by permissions of each user.
    Only widgets with access are actually part of the dashboard.
    Have a look at [Permissions of widgets](https://docs.typo3.org/permalink/typo3/cms-dashboard:permission-handling-of-widgets@main) to understand how to handle permissions.

-   **showInWizard**

    -   *Type:* bool

    Boolean value to indicate, whether this preset should be visible in the wizard,
    when creating new dashboards, see [Adding Dashboard](https://docs.typo3.org/permalink/typo3/cms-dashboard:adding-dashboard@main).

    This can be disabled, to add presets via [Configure preset for user](https://docs.typo3.org/permalink/typo3/cms-dashboard:configure-preset-for-user@main), without
    showing up in the wizard.

## Configure preset for user {#configure-preset-for-user}

To define the default preset for a backend user, the following User TSconfig can be added:

```typoscript
options.dashboard.dashboardPresetsForNewUsers = default
```

Where `default` is the identifier of the preset.
Even a comma separated list of identifiers is possible:

```typoscript
options.dashboard.dashboardPresetsForNewUsers = default, companyDefault
```

It is also possible to add another dashboard to the set of dashboards:

```typoscript
options.dashboard.dashboardPresetsForNewUsers := addToList(anotherOne)
```

If nothing is configured, `default` will be used as identifier.

> [!NOTE]
> **See also**
>
> [Importing the user TSconfig into a backend user or group](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/UsingSettingTSconfig/UserTSconfig.html#userthetsconfigfield) section of TSconfig manual
> explains how to set or register TSconfig for user.
>
> [Value modifications with ":="](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/Syntax/Operators/Index.html#typoscript-syntax-syntax-value-modification) explains the usage of
> `:=` TypoScript operator.