| Table of Contents |
Dashboards provide a way to display any kind of data through widgets at different levels:
- Global dashboard: to display information at Sonar instance level (available since Sonar 3.1).
- Project dashboard: to display information at project level.
Overview
Concepts and mechanisms describe below apply for both global and project dashboards.
Creating Dashboard
Logged users can create as many dashboards as they need.

Click on Manage dashboards and fill the form to create a new dashboard:

The newly created dashboard will appear immediately in the left navigation bar and and can be customised by adding widgets.
When administrators create a dashboard, they have the ability to share it. This means that this dashboard can be followed by authenticated users and can also be used as a default dashboard. This is done by ticking Shared:

Customizing Dashboard
The content of a dashboard can be fully customized.
Changing Layout
To change the layout of a dashboard (e.g. three columns instead of two), click on Configure widgets and then pick a layout on the right hand side:

Adding a Widget
To add a widget, click on Configure widgets. The list of available widgets is shown at the top of the page. Click on Add widget to add the desired widget:

Moving a Widget
To move a widget within a dashboard, click on Configure widgets, then drag & drop the widget.

Removing a Widget
To remove a widget, click on Configure widgets and then click on Delete:

Managing Dashboards
Click on Manage dashboards to manage available dashboards:

From there you can:
- Follow / Unfollow a shared dashboard
- Change the order of the dashboards in the left navigation bar
- Delete a dashboard
- Configure widgets
Managing Default Dashboards
An administrator can customise the list and the content of the default dashboards. The default dashboards are the ones presented to unauthenticated users as well as authenticated users that have not done any customization. This is done by logging in, go to Configuration > Default dashboards and then select default dashboards to display and their order,

Project Dashboard
The project dashboard is the entry point when looking at a project. It presents an overview of the project measures.

Global Dashboard
Overview
Global dashboards are available at instance level and can be accessed through the menu on the left.
Any widget can be added to a global dashboard. Thus, any kinds of information from a project or from the Sonar instance can be displayed at will.
Global Dashboards Shipped with Sonar
By default, Sonar is shipped with three global dashboards:
My favourites
This dashboard includes one filter that lists all the resources that have been flagged as favourite by the logged user. See this tutorial to know how to flag a resource as favourite:

Projects
This dashboard includes one filter that lists all the projects of the Sonar instance:

Treemap
This dashboard includes one filter that displays all the projects of the Sonar instance as a Treemap (size = number of lines, color = rules compliance):


