---
title: "Doughnut Chart Widget"
manual: "Dashboard"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-dashboard:doughnut-chart-widget@main"
source: "Widgets/DoughnutChartWidget.rst"
rendered: "2026-10-01T18:11:41+00:00"
---

# Doughnut Chart Widget {#doughnut-chart-widget}

-   **class DoughnutChartWidget**

    -   *Fully qualified name:* `\TYPO3\CMS\Dashboard\Widgets\DoughnutChartWidget`

Widgets using this class will show a doughnut chart with the provided data.

This kind of widgets are useful if you want to show the relational proportions
between data.

![Doughnut chart widget with the proportion of normal and admin users](../Images/Widgets/DoughnutChartWidget.png)

## Example {#doughnut-chart-widget-example}

**Excerpt from EXT:dashboard/Configuration/Services.yaml**

```yaml
services:
 dashboard.widget.typeOfUsers:
    class: 'TYPO3\CMS\Dashboard\Widgets\DoughnutChartWidget'
    arguments:
      $dataProvider: '@TYPO3\CMS\Dashboard\Widgets\Provider\TypeOfUsersChartDataProvider'
      $options:
         refreshAvailable: true
    tags:
      - name: dashboard.widget
        identifier: 'typeOfUsers'
        groupNames: 'systemInfo'
        title: 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widgets.typeOfUsers.title'
        description: 'LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widgets.typeOfUsers.description'
        iconIdentifier: 'content-widget-chart-pie'
        height: 'medium'
```

## Options {#doughnut-chart-widget-options}

-   **refreshAvailable**

    -   *Type:* boolean
    -   *Default:* `false`

    Boolean value, either `false` or `true`.

    Provides a refresh button to backend users to refresh the widget.
    If the option is omitted `false` is assumed.

## Dependencies {#doughnut-chart-widget-dependencies}

-   **$dataProvider**

    -   *Type:* `\TYPO3\CMS\Dashboard\Widgets\ChartDataProviderInterface`

    To add data to a Bar Chart widget, you need to have a DataProvider that implements
    the interface `\TYPO3\CMS\Dashboard\Widgets\ChartDataProviderInterface`.

    See [Implement graph widget](https://docs.typo3.org/permalink/typo3/cms-dashboard:graph-widget-implementation@main) for further information.

-   **$buttonProvider**

    -   *Type:* `\TYPO3\CMS\Dashboard\Widgets\ButtonProviderInterface`

    Optionally you can add a button with a link to some additional data.
    This button should be provided by a ButtonProvider that implements the interface
    `\TYPO3\CMS\Dashboard\Widgets\ButtonProviderInterface`.

    See [Adding button to Widget](https://docs.typo3.org/permalink/typo3/cms-dashboard:adding-buttons@main) for further info and configuration options.