JIRA
Install
Admin
Use
Search JIRA documentation:

Configuring the Default Dashboard

PDF
PDF

The default dashboard is the screen that all JIRA users see the first time they login. Any users who have not configured a personal dashboard also see the default dashboard.

JIRA allows Administrators to configure the default dashboard. The portlets on the default dashboard can be re-ordered, switched between the left and right columns, additional portlets can be added, and some portlets can be configured.

All changes made to the default dashboard will also change the dashboards of all users currently using the default. However, portlets that users do not have permissions to see will not be displayed to them. For example, the 'Administration' portlet, although it may exist in the default dashboard configuration, will not be visible to non-admin users.

Note
Portlets are the information boxes on the Dashboard. JIRA comes pre-configured with a set of standard dashboard portlets. Please note that it is possible to develop custom portlets and plug them into JIRA using its flexible plugin system.

Moving and configuring portlets

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard:

    Link to Administration sectionLink to Administration section

  3. Click the "Default Dashboard" link under "Global Settings" on the left pane.
  4. This will display the "Configure Default Dashboard" screen, which consists of two selectable areas listing the current portlets. The portlets can be configured as follows:
    Move a portlet up Select the portlet, and click the "^" closest to select area that contains the portlet.
    Move a portlet down Select the portlet, and click the "v" closest to select area that contains the portlet.
    Move a portlet left Select the portlet in the right hand column, and click the "<" button.
    Move a portlet right Select the portlet in the left hand column, and click the ">" button.
    Configure a portlet Select the portlet, and press the "Edit" button.
    Delete a portlet Select the portlet and press the "Delete" button.

Adding a portlet

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard:

    Link to Administration sectionLink to Administration section

  3. Click the "Default Dashboard" link under "Global Settings" on the left pane.
  4. Click the "Add" button on the "Configure Default Dashboard" screen to display a preview of the available portlets and how much of each already exists on the current default dashboard.
    Add Portlet page
  5. Select the radio button for the portlet you want, and press the "Add" button.
  6. If the portlet you have selected requires configuration, you will be presented with the portlet's configuration page. Configure appropriately and press "Save".
Note
JIRA's default dashboard is limited to only one dashboard page. However, users can add multiple pages to their own dashboards if they wish.