# Viewing and managing dashboards

This feature is available in the [Enterprise](https://www.sonarsource.com/plans-and-pricing/sonarcloud/) plan.

{% hint style="info" %}
This feature is in beta.
{% endhint %}

## Retrieving portfolio dashboards

To retrieve **Dashboards**:

1. Retrieve your portfolio. See [#retrieving-portfolio](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/viewing-enterprise-reports/viewing-portfolios#retrieving-portfolio "mention") for more information.
2. Go to **Dashboards** > **All dashboards**. The dashboard page opens with all available dashboards.

## Permissions

* **View** portfolio permission is required to view, create and edit dashboards. See [administering-portfolios](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/administering-portfolios "mention") for more details.

## A list of all dashboards

The **All dashboards** page shows a list of dashboards for your portfolio.

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2FFQ8j2PVfpSHZA565J6BK%2Fportfolio-dash-all%20(1).png?alt=media&#x26;token=4abdcc59-df11-43e9-ae2a-e4392955f24c" alt="All dashboards page"><figcaption></figcaption></figure>

1. Click on **All**, **Built-in** or **Custom** buttons to filter the dashboard or use the search to find a dashboard by name.
2. Click **Create custom dashboards** to create a new dashboard. See [creating-dashboards](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards "mention") for more details.
3. The list is organized by **Dashboard name**, **Last edited**, and **Creator**.
4. The action menu at the end of each row shows:
   * **Edit name and description**: Available to custom dashboards.
   * **Edit dashboard**: Available to custom dashboards.
   * **Duplicate**: Available to custom and built-in dashboards.
   * **Delete dashboard**: Available to custom dashboards.

## Viewing dashboards

Dashboards comprise configurable widgets. Depending on the type of a measure they represent, the widgets are count, rating badge, line chart, pie and donut charts.

### Count

Count represents a single metric. It displays a numerical value for a measure, for example, the number of security hotspots or the percentage of debt ratio.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-4bdbff0267ef97cf8b5c0d3f829f0d2809ce5ca4%2Fdashboards-count.png?alt=media" alt="The count widget" width="563"><figcaption></figcaption></figure></div>

* In the upper-right corner, the chart shows whether the data is applied to new or overall code.
* If enabled during widget creation, the widget displays the net change in the last 30 days. Click on it to investigate further on the Activity page.

### Badge

A rating represents a single metric. It displays the current rating for a measure, for example, a security rating or reliability rating.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-822616d007b094308fa4a6b593c5866c2e39d9b6%2Fdashboards-rating%20(1).png?alt=media" alt="The rating widget" width="341"><figcaption></figcaption></figure></div>

In the upper-right corner, the chart shows whether the data is applied to new or overall code.

### Line chart

A line chart represents metrics that change over time, displaying historical data for a selected measure.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-e3e2b77d102fc6f8de7d2d4b7f2fa07979d85428%2Fdashboards-line-chart%20(1).png?alt=media" alt="The line chart widget" width="563"><figcaption></figcaption></figure></div>

* Hover over the line to reveal a tooltip with additional information.
* In the upper-right corner, the chart shows that data is applied to overall code, which is the only option for line charts.
* If enabled during widget creation, the chart displays a legend.

### Pie and donut charts

Pie and donut charts display information for multiple metrics.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-1fd1335203f4d92a226bea60e48a64353bd704e7%2Fdashboards-pie-chart%20(2).png?alt=media" alt="The pie chart widget" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-fae0557f4c4c395e86fde730de36d2ebd1113900%2Fdashboards-donut-chart%20(2).png?alt=media" alt="The donut chart widget" width="563"><figcaption></figcaption></figure></div>

* Hover over a section of the pie or donut chart to reveal a tooltip with more information.
* Click on the pie or donut chart sections, or on the legend, to drill down into the metrics.
* In the upper-right corner, the chart shows whether the data is applied to new or overall code.
* If enabled during widget creation, the chart displays a legend.

See the [#metrics](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/creating-dashboards#metrics "mention") section for more information about the metrics used by the dashboards.

### Missing a visualization or metric?

Your feedback is important to us. Submit your ideas for a visualization or metric that you would like to see in Dashboards through our [Portal card](https://portal.productboard.com/sonarsource/1-sonarqube-cloud/c/802-dashboards-improvements).

## Editing a dashboard

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2FRZlY0cSRvAlxUu2YAVAX%2Fportfolio-dash-edit.png?alt=media&#x26;token=a9305156-1993-4f17-8621-b67a9da31b7b" alt="Editing a custom dashboard"><figcaption></figcaption></figure>

Navigate to the custom dashboard you wish to edit and select **Edit dashboard**. Alternatively, you can navigate to the **All dashboards** page and select **Edit** from the action menu located on the right-side of the dashboard you wish to edit.

In the edit mode you have an option to:

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2F4Dbi0B5IrNWpmYseHOiF%2Fportfolio-dash-edit-mode.png?alt=media&#x26;token=51057f81-ef8e-4bfd-b0a3-25e519e28c12" alt="Dashboard&#x27;s edit options"><figcaption></figcaption></figure>

* **Cancel and exit**: Exits the edit mode without saving the changes.
* **Save changes**: Saves the existing changes.
* **Add widget**: You can choose from available widgets.
* **Add section:** Sections group a set of widgets together and are collapsible.

See [creating-dashboards](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards "mention") for more details about how to create and customize the widgets and sections.

### Organizing your dashboards

#### **Widgets**

You can organize widgets by moving them from one section to another. In edit mode, click the handle located in the top-left corner of a widget and drag it to another location.

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-2a822ae1852776dbbc990eade67b584e1ad5cf1b%2Fdashboards-moving-widgets.png?alt=media" alt="Moving a widget"><figcaption></figcaption></figure>

Additionally, you can resize a widget by clicking and dragging its lower-right corner.

#### **Sections**

Similarly to widgets, you can drag sections from one location of the dashboard to another.

Sections are collapsible, even after you save the changes and exit the edit mode. This can help you save screen real estate and show only information that is important to you at a given moment.

## Related pages

* [](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/portfolio-dashboards "mention")
* [creating-dashboards](https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards "mention")