---
title: "Dashboard"
manual: "Content Planner"
version: "2.5"
source: "Usage/Dashboard.rst"
modified: "2026-09-16T11:40:44+00:00"
---

# Dashboard

**Table of Contents**

-   [Create](#create)
-   [Widgets](#widgets)
-   [Configurable Widget](#configurable-widget)

The extension brings a prepared dashboard preset with a set of widgets to support the content planning process.

## Create

To create a new dashboard, click on the "Add dashboard" (+) button near the dashboard tabs in the dashboard module.

![Create new dashboard using the preset](../Images/dashboard-new.jpg)

Otherwise you can add the widgets manually to an existing dashboard.

![Select the content planner widgets](../Images/widget-select.jpg)

## Widgets

The dashboard provides a set of helpful widgets to get an overview of the current status of the content planner records.

![Dashboard overview](../Images/dashboard-overview.png)

![Overview](../Images/widgets/dashboard-overview.png)

-   **Overview**

    Bar chart showing the distribution of records by status.

![Recent Updates](../Images/widgets/dashboard-updates.png)

-   **Recent Updates**

    Update stream showing the latest changes to the content planner records.

![Current Assignee](../Images/widgets/dashboard-assignee.png)

-   **Current Assignee**

    Short list with all records assigned to the current user.

![ToDo](../Images/widgets/dashboard-todo.png)

-   **ToDo**

    Display all records with open todos in the comments.

![Recent Comments](../Images/widgets/dashboard-comments.png)

-   **Recent Comments**

    Shows the latest comments on the content planner records.

![Status](../Images/widgets/dashboard-status.png)

-   **Status**

    Filterable list of all records with the current status.

![Content Planner (Configurable)](../Images/widgets/dashboard-custom.png)

-   **Content Planner (Configurable)**

    A fully customizable widget that combines the functionality of multiple widgets.
    Available in TYPO3 v14+ only. See [Configurable Widget](#dashboard-configurable-widget) for details.

## Configurable Widget

> [!NOTE]
> **New in version 2.0.0**
>
> [Feature: #161 - Add configurable dashboard widget](https://github.com/xima-media/xima-typo3-content-planner/pull/161)

> [!IMPORTANT]
> This widget requires TYPO3 v14+ and uses the new [Dashboard Widget Settings API](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.0/Feature-107036-ConfigurableDashboardWidgets.html).

The **Content Planner (Configurable)** widget is a powerful, customizable widget.
It allows you to create multiple instances with different configurations, each tailored to your specific needs.

### Settings

The widget can be configured through the widget settings dialog:

![Configurable widget settings dialog](../Images/widget-custom.jpg)

| Setting: | Description: |
| --- | --- |
| Custom Title | Set a custom title for the widget. If left empty, an automatic title based on the selected mode will be used. |
| Display Mode | Choose what kind of records to display: -   **All Status Records**: Shows all records with any content planner status -   **Assigned Records**: Shows records filtered by assignee -   **Records with open TODOs**: Shows only records that have open tasks in their comments |
| Status Filter | Filter records by a specific status. Select "All statuses" to show records with any status. |
| Assignee Filter | Filter records by assignee: -   **All assignees**: No assignee filter -   **Current User**: Shows only records assigned to the logged-in user -   **Specific user**: Select a specific backend user |
| Record Type Filter | Filter records by table type (e.g., pages, news, etc.). Select "All record types" to show all registered tables. |

### Use Cases

Here are some example configurations:

-   ****Personal Task List****

    Set "Display Mode" to "Assigned Records" and "Assignee Filter" to "Current User" with a custom title like "My Tasks".

-   ****Review Queue****

    Set "Status Filter" to your "In Review" status to create a dedicated review queue widget.

-   ****Open TODOs Overview****

    Set "Display Mode" to "Records with open TODOs" to track all unfinished tasks across the project.

-   ****News Articles Status****

    Set "Record Type Filter" to "News" to monitor only news article statuses.