Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
JIRA allows you to configure more than one dashboard page. Each dashboard page can be configured independently, allowing you to neatly organise related information by context. You can also share your dashboard pages with other users, as well as adding dashboards shared by other users as favourites.
Each dashboard page appears as a separate "tab" on the dashboard. You can view a dashboard page by simply clicking its name in the tab list.
On this page:
The 'Manage Dashboards' page allows you to view and configure dashboard pages that you have created, as well as work with dashboard pages that other users have shared with you.
Click the above links for further details on each function.
You can also re-order your dashboard pages on this page, by using the arrow icons:
Move a dashboard up | Click the up arrow () for the dashboard that you wish to move. |
Move a dashboard down | Click the down arrow () for the dashboard that you wish to move. |
Move a dashboard to the top of the list | Click the curly up arrow () for the dashboard that you wish to move. |
Move a dashboard to the bottom of the list | Click the curly down arrow () for the dashboard that you wish to move. |
To create a new dashboard page please follow these steps:
The sharing of your new dashboard page depends on your sharing preference in your user profile. If you have not specified a personal preference, then the global default for sharing will apply (i.e. 'Private', unless changed by your JIRA Administrator under 'User Defaults' in the Administration menu). If you wish to change the sharing of your dashboard page, refer to the instructions on sharing dashboard pages below.
Please note, you need the 'Create Shared Object' global permission to be able to share your dashboard page. If you cannot see any dashboard sharing functionality, contact your JIRA Administrator to be granted this permission.
Dashboard pages that you have created, or that have been shared by other people, can be added as a 'favourite'. This means that the dashboard page will appear as a tab on the left side of your browser window, when viewing your JIRA dashboards. There is no restriction on the number of dashboards that you can add as a 'favourite' and each of these will appear on an individual tab when viewing your JIRA dashboards.
To add an existing dashboard page to your dashboard:
Please note, if you have added another user's shared dashboard as a favourite and a gadget(s) is not displaying correctly, the gadget(s) may be using an issue filter that is not shared with you. You will need to contact the author of the issue filter to change the filter sharing.
To remove a dashboard page from your dashboard:
Please note, if you do not have any dashboard pages added as favourites, the default dashboard will be displayed on your dashboard with an error message. You can choose to keep the default dashboard displayed on your dashboard, but you will need to add it as a favourite to stop the error message from showing. You may need to search for the 'System Default' dashboard to add it as a favourite.
JIRA also allows you to share any dashboard pages that you have configured. Dashboard pages can be shared with other users via user groups, projects and project roles. Dashboard pages can also be shared globally. Sharing a dashboard page allows other users to display it on their JIRA dashboard, by selecting it as a favourite.
Please note, you may need to review the sharing permissions for any issue filters used in portlets on your shared dashboard. If another user adds your dashboard as a favourite, but cannot access a filter for a portlet, then the portlet will display with an error message.
To share an existing dashboard page to the dashboard, please follow these steps:
Click the 'Update' button to save your changes.
Please note, you be able to share your dashboard only with the groups that you are member of.
Dashboard pages that you have created or have been shared by other users, can be found via the dashboard Search function of the 'Manage Dashboards' page. If it is a popular dashboard (i.e. added as a favourite by many users), you can also locate it on the 'Popular' tab of the 'Manage Dashboards' page which lists the top twenty most popular dashboards.
To search for an existing dashboard page, please follow the steps below:
You can always update the details, i.e. Name, Description, Sharing, Favourite, of an existing dashboard page after its creation. Please note that you can only update the details of dashboard pages which you have created.
To update the details of one of your existing dashboard pages, please follow the steps below:
You can make a copy of an existing dashboard page (created by you or shared with you), which creates a new dashboard page with the same gadget configuration as the existing dashboard page.
To update the details of one of your existing dashboard pages, please follow the steps below:
Please note that you can only delete dashboard pages that you created.
To delete a dashboard pages, please follow the steps below:
A confirmation message box will appear. This message will also inform you if (and how many) other users have selected this dashboard as a favourite. If you wish to continue with the deletion, click the 'Delete' button. Otherwise, click the 'x' in the top right of the message box to cancel this action.
Be aware that deleting a dashboard which other users have marked as a favourite will prevent these users from accessing that dashboard in future.
This feature is only available in JIRA 4.4.1 and later.
A shared dashboard is a dashboard whose creator has shared that dashboard with other users. Refer to Sharing Dashboard Pages above for details. When a shared dashboard is created by a user, that user:
If you have the 'JIRA Administrators' global permission, you can manage shared dashboards that were created by other users.
To access the 'Shared Dashboards' feature: