This page walks you through the setup step by step, from an empty dashboard to a shared view of your important Jira data. This example uses three gadgets. You can use any gadget that is compatible with your datasource, or a utility gadget, like Rich Text, that doesn’t need source data.

In the left sidebar in Jira, select Apps > Dashboard Hub. This is the home for all your dashboards, where you'll view, create, and manage them.

1. Option A: If this is the first time you open Dashboard Hub, click Create dashboard on the Get started page.
   Option B: In Dashboard Hub, click More actions (…) in the top right, then select Create dashboard.

2. Enter a name for your dashboard, for example, My first dashboard.

1. Click Add gadget at the top of the dashboard, or Browse all.
   
   

   Open

   

2. Click Select multiple to add more than one gadget at a time.

3. Select Show only compatible datasource to ensure only compatible gadgets are available.

   Open

   

4. Select two or three gadgets, depending on the data you want to visualize. In this example, we select Jira Custom Charts, Progress Tracker, and Rich Text.

5. Click Add gadgets.

1. Click Config on the Jira Custom Charts gadget. This is the most versatile gadget.

2. The gadget name displays by default, but you can change it so it is more meaningful to you and your team.

3. Your data is already connected. The instance where Dashboard Hub is installed is your default datasource, called This Jira instance.

4. Most gadgets use JQL queries or saved filters to determine the work items used to build the report. If your instance has a large number of work items or spaces, add a JQL query or select a saved JQL filter to narrow the number of work items to load; query a specific work type, assignee, or space, for example, project = Birch.

5. Click Load.
   
   

   Open

   

1. View Type: Depending on the selected gadget, you have different visualization options. For the Jira Custom Charts gadget in this example, select Pie Chart.

2. Chart By: Choose how to segment the data. Here, we use Issue Type.

3. Keep the default Aggregation Field and Aggregation options.

4. (optional) If you want to include a statistic in the rendered gadget, select an option under Show statistics. In this example, we select Total Work Items.

5. A preview of the rendered data displays. When you are happy with the visualization, click Save.
   
   

   Open

   

The Progress Tracker gadget can display progress at the Epic, Theme, and Initiative level, or other work types by different estimation statistics.

1. Follow the instructions in Step 4, using a JQL query that matches your instance.
   
   

   Open

   

2. Select the start and end date fields, for example Created and Resolved, or use custom fields.

3. Select the metric to use to calculate progress, for example, Work Item Count.

4. Choose the view type: List or Extended.

5. Click Save.

The Rich Text gadget is a utility gadget that doesn’t require a datasource. Use it to provide contextual information to your dashboards, such as a team and project description, what reports are included, or how to customize view with adaptive filters. The rich content supports formatted text, links, emojis, lists, images, and videos.

1. Click Config.

2. Add the content that you want to display on your dashboard.

3. Click Save.

When you are ready, click Save in the top right of the dashboard. The new dashboard displays.

Open

You created your first dashboard. What’s next?

• Understand dashboard permissions

• Subscribe to a dashboard

• Learn about connection types and datasources

• Customize dashboard adaptive filters

• Learn more about the gadgets used in this example

  • Jira Custom Charts

  • Progress Tracker

  • Rich Text