# Dashboards - How to use Jira

'define expected-reading 2 min
'define created 24 July 2020
'define edited 03 June 2021
[$pagenav]

'define start_link ./
'define prev_link ./components.html Components
[$pagination_end]

.contents
.numbered
1. [url #adding-a-dashboard Adding a dashboard]
2. [url #adding-gadgets Adding gadgets]

Dashboards are a =[place where you can view a lot of information]=.

[image ./img/default-dashboard.png]

Dashboards are composed of =[gadgets]=.

[image ./img/gadgets.png]

Gadgets have functionality for =[displaying certain information]=, like `[Average Age Chart]` or `[Issues in progress]`. Each gadget can be setup to =[take information from one or more projects and/or saved filters]=.

## Adding a dashboard

Dashboard can be added from the top bar, under `[Create dashboard]` in the `[Dashboards]` menu

[image ./img/create-dashboard-top.png]

or, if you are already in a dashboard, from `[Create dashboard]` in the three dots menu.

[image ./img/create-dashboard-dots.png]

## Adding gadgets

=[Note]=: you cannot add gadgets to the default dashboard.

You can add gadgets either =[through the `[Add gadget]` button in the top right]=

[image ./img/add-gadget-top.png]

or, =[if you don't have any gadets]=, =[from the `[add a new gadget]` message(s)]=.

[image ./img/add-a-gadget.png]

After that, you are greeted by a window that =[shows all of the avalable ones]= (you might need to =[press `[Load all gadgets]`]=).

[image ./img/load-all.png]

[image ./img/add-gadget.png]

Adding a gadget is as simple as clicking the button `[Add gadget]` next to the name of the gadget you want to add.

[image ./img/introduction-add.png]

After it is added, you'll =[need to configure it]=, usually a gadget =[requires atleast a filter/project]=.

[image ./img/bubble.png]

Options for different gadgets can be found on =[their top right corner, in the three dots menu]=.

[image ./img/bubble-dots.png]