Viewing and managing dashboards
In SonarQube Server 2026.5, you can monitor key metrics of your project, identify risks and communicate progress using configurable dashboards.
Project dashboards are available starting in Enterprise edition.
Retrieving project dashboards
To retrieve Dashboards:
Retrieve your project. See Retrieving projects for more information.
Go to Dashboards. The All dashboards page opens and lists all available dashboards.
Permissions
Private projects:
The Browse permission is required to view, create, and edit project dashboards.
Public projects:
Anyone can view project dashboards, including any custom dashboards.
Only authenticated users can create and edit project dashboards.
A list of all dashboards
The All dashboards page shows a list of dashboards for your project.
Select All, Built-in, or Custom to filter dashboards, or use search to find one by name.
Select Create custom dashboard to create a new dashboard. See Creating dashboards for more details.
The list is organized by Dashboard name, Last edited, and Creator. Select the name of the dashboard to view it.
The action menu at the end of each row shows:
Edit name and description: Available to custom dashboards.
Duplicate: Available to custom and built-in dashboards.
Delete dashboard: Available to custom dashboards.
Built-in dashboards
SonarQube Server 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 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 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.
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.
Hover over a line to reveal a tooltip with additional information.
Line charts apply to overall code only. When the selected metric supports it, the chart is grouped into multiple lines.
If enabled during widget creation, the chart displays a legend.
Donut and pie charts
Donut and pie charts display information across multiple values.
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 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 the SonarQube Server portal.
Dashboard history retention
Widgets that show historical data, such as line charts and trend indicators, rely on the dashboard history that SonarQube Server collects. An instance administrator controls how long this history is kept through the housekeeping settings. See Housekeeping for more information.
Editing a dashboard
Go to the custom dashboard you want to edit and select Edit dashboard.
In edit mode, you can:
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 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.
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
Last updated
Was this helpful?