# 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 [Viewing portfolios](/sonarqube-cloud/getting-started-with-enterprise/viewing-enterprise-reports/viewing-portfolios.md#retrieving-portfolio) 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](/sonarqube-cloud/getting-started-with-enterprise/administering-portfolios.md) for more details.

## A list of all dashboards

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

<figure><img src="/files/vfACZtBS56BBezOdMEoc" 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](/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards.md) 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, 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 duplications.

<div align="left"><figure><img src="/files/KRIHOdsjoNVTDqREATjK" 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. Click on it to investigate further on the Activity page.
* If enabled during widget creation, the widget displays the net change in the last 30 days.

### Badge

A badge 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="/files/41q8wUMhiTUQv0DVoXxE" alt="The rating 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.
* Hover over a slice to reveal more information.
* Click on the slices to drill down into the details.

### Line chart

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

<div align="left"><figure><img src="/files/V5TBfJsVE6rPIUYPnQfY" 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.

### Donut and pie charts

Donut and pie charts display information for multiple metrics.

<div align="left"><figure><img src="/files/8gVX4nKnJEhe8ym1Zjzi" alt="The pie chart widget" width="563"><figcaption></figcaption></figure></div>

* Hover over a section of the donut or pie 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 [Creating dashboards](/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards.md#metrics) 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).

### Drilling down on metrics

Widgets contain clickable parts that you can use to drill down on metrics and measures. Once clicked, you are taken to a separate page where you see a breakdown of the metric or measure by projects. You can drill down on all widgets with the exception of the line chart.

<figure><img src="/files/pdQUtHWCuVihxvNw3rUL" alt="Breakdown by project page"><figcaption></figcaption></figure>

1. Click on different parts of the widget to filter the results of the projects shown in the **Breakdown by projects** section.
2. Use the drop-down menu to filter the results.
3. **Breakdown by project**: View the results of the projects affected by the metric or measure. Only the projects you have the Browse permission for are listed. Use the search box to filter the list by project name.
   1. Click the project name to navigate to the project's Summary page.
   2. Click the number of issues or a rating to navigate to the project's Issues or Measures page.

## Editing a dashboard

<figure><img src="/files/b8ExJxNeVmkKQwb5WlyK" 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="/files/gY9GHhLApdvPiANNHQiN" 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](/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards.md) 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="/files/9yfsF7tGDyStpIoflGuq" 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

* [Portfolio dashboards](/sonarqube-cloud/managing-portfolios/portfolio-dashboards.md)
* [Creating dashboards](/sonarqube-cloud/managing-portfolios/portfolio-dashboards/creating-dashboards.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-cloud/managing-portfolios/portfolio-dashboards/viewing-and-managing-dashboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.