Skip to main content

Custom Dashboard

Create a shared dashboard showing open issues and pull requests assigned to the person viewing it.

Prerequisites​

Custom dashboards require an active Enterprise subscription or trial. An administrator can check this under Administration → Subscription Management. Group members also need appropriate access to the projects shown by the widgets.

Add the Widgets​

  1. Open Dashboards, click + in the dashboard toolbar, and enter a dashboard name.

  2. Click Add Widget. Under Tabs, click + and choose Issue list. Enter a title such as My open issues. Leave Project at All accessible and use this Base Query, replacing tutorial-dashboard with your project path:

    "Project" is "tutorial-dashboard" and "State" is "Open" and "Assignees" is me

    Adjust state and assignee field names if your issue settings differ. To include all accessible projects, remove the "Project" is ... and clause.

    Issue-list widget with a current-user base query

  3. Click Ok, then Add Widget again. Add a Pull request list tab titled My open pull requests. Leave Project at All accessible and enter:

    "Target Project" is "tutorial-dashboard" and open and assigned to me

    Remove the target-project clause to include all accessible projects. Use separate widgets to display both lists simultaneously; multiple tabs within one widget share the same panel.

  4. Click Ok, then Save in the dashboard toolbar. The saved example below uses a stacked layout.

Share the Dashboard​

Click Share dashboard in the dashboard toolbar, select the group under Share with Groups, and click Ok. You can share with groups you belong to; sharing with other groups or everyone requires administrator privileges.

Share the dashboard with a group

Sharing a dashboard does not grant access to its underlying projects. List results remain limited by the viewer's permissions. A widget configured for a particular inaccessible project may report a permission error instead.

Verify as a Group Member​

Sign in as a group member and open Dashboards. Select the shared dashboard if necessary. With only this custom dashboard available, it is selected automatically. The me conditions refer to the viewer, so each member sees their own assigned work.

Shared dashboard showing the test member's assigned issue and pull request

For a useful check, assign different issues and pull requests to two users, then view the same dashboard as each. Removing a member's project access should remove those project results even while the dashboard remains shared.