> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-cloud/managing-your-projects/dashboards/viewing-and-managing-dashboards.md). # Viewing and managing dashboards This feature is available in the [Enterprise](https://www.sonarsource.com/plans-and-pricing/sonarcloud/) plan. ## Retrieving project dashboards To retrieve **Dashboards**: 1. Retrieve your project. See [Retrieving projects](/sonarqube-cloud/managing-your-projects/retrieving-projects.md) for more information. 2. Go to **Dashboards**. The **Dashboards** page opens and lists all available dashboards. ## Permissions Private project: * The Browse permission is required to view, create, and edit project dashboards. Public projects: * Anyone can view project dashboards, including any custom dashboards. * Members of the organization that the project belongs to can edit and create project dashboards. ## A list of all dashboards The **Dashboards** page shows a list of dashboards for your project.
All dashboards page
1. Click **All**, **Built-in**, or **Custom** to filter dashboards, or use search to find one by name. 2. Click **Create custom dashboard** to create a new dashboard. See [Creating dashboards](/sonarqube-cloud/managing-your-projects/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. ### Built-in dashboards SonarQube Cloud ships with two built-in dashboards for projects: The **Project health dashboard** provides teams with an immediate view of a project’s health by surfacing key measures, trends, and risk breakdowns for overall code across Security, Reliability, and Maintainability, while also monitoring coverage and duplication. The **Security overview** dashboard provides teams with an immediate, high-level summary of their security posture, allowing them to understand risk status and trends without needing to drill into individual findings. ## Viewing dashboards Dashboards comprise configurable widgets. Depending on the measure type, widgets can be count, badge, line and multi-line, pie, donut, and top list charts. ### Count Count represents a single metric. It displays a numeric value for a measure, such as the number of security hotspots or the duplication percentage.
The count widget
* The chart shows whether the data applies to new code or overall code. * Click the value to drill into the details. * 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, such as a security rating or reliability rating.
The rating widget
* The chart shows whether the data applies to new code or overall code. * Hover over a slice to reveal more information. * Click a slice to drill down into the details. ### Line and multi-line charts A line chart represents metrics that change over time and displays historical data for a selected measure.
The line chart widget
A multi-line chart becomes available when you apply a **Group by** filter to a supported metric. For instance, you can select **Issue count** and group the results by **Software quality**.
Multiple line chart
* Hover over a line to reveal a tooltip with additional information. * The chart shows that line charts apply to overall code only, plus grouping when it is available for the selected metric. * If enabled during widget creation, the chart displays a legend. ### Donut and pie charts Donut and pie charts display information across multiple values.
The pie chart widget
* Hover over a section of the donut or pie chart to reveal a tooltip with more information. * Click a section of the chart, or its legend, to drill down into the details. * The chart shows whether the data applies to new code or overall code. * If enabled during widget creation, the chart displays a legend. ### Top list Top lists display the leading results for a specific metric and their associated trends. For instance, you can view the top five rules that raised issues, filtered by their open status.
* Click a row to drill down into the details. See the [Creating dashboards](/sonarqube-cloud/managing-your-projects/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). ## Editing a dashboard
Editing a dashboard
Navigate to the custom dashboard you want to edit and select **Edit dashboard**. Alternatively, go to the **Dashboards** page and select **Edit** from the action menu on the right side of the dashboard. In edit mode, you can:
Editing options
* **Cancel and exit**: Exits edit mode without saving changes. * **Save changes**: Saves your changes. * **Add widget**: Choose from the available widgets. * **Add section**: Sections group a set of widgets together and are collapsible. See [Creating dashboards](/sonarqube-cloud/managing-your-projects/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 on top of a widget and drag it to another location.
Moving a widget
You can also resize a widget by clicking and dragging its lower-right corner. #### **Sections** Like widgets, you can drag sections from one location on the dashboard to another. Sections remain collapsible after you save your changes and exit edit mode. This helps you save screen space and show only the information you need at a given moment. ## Related pages * [Project dashboards](/sonarqube-cloud/managing-your-projects/dashboards.md) * [Creating dashboards](/sonarqube-cloud/managing-your-projects/dashboards/creating-dashboards.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.sonarsource.com/sonarqube-cloud/managing-your-projects/dashboards/viewing-and-managing-dashboards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.