Add and Configure Gadgets

Overview

We already learnt in What is a Gadget? that gadgets are the main components of a dashboard and that allow you to display information using the best visual representation.

The common elements to all gadgets are:

• Name. You describe the function of the gadget so that everyone understands it. Be precise and concise, and not too verbose. When you connect to different Jira instances, also indicate the datasource.

• Datasource. This is the source of truth, the origin of the data. Review Learn about Datasources.

Configure gadgets

To configure gadgets, you have to be in Edit mode.

To enter Edit mode, click on the Edit button in the right top navigation bar

1. Click on the to open the configuration menu, or click on the Config button.

2. Name your gadget.

3. Select a datasource, default for the current instance, or any other (see Add and Manage Datasources

Now, depending on the gadget datasource, you see different configuration options. Some of them requires you to indicate a project, a board, a sprint, a queue, a time period…

Open

The last option before clicking on Save, is common to all gadgets “Use this setting to configure empty compatible gadgets”. If you enable this toggle, all the gadgets with a compatible configuration will be configured equally, saving you time.

4. Click Save.

Add gadgets

To add gadgets, you have to be in Edit mode.
To enter Edit mode, click on the Edit button in the right top navigation bar: new controls are displayed in the middle of the top navigation bar:

1. Click on the add gadget button to open the gadgets catalog menu (see Dashboard Gadgets: KPIs and Metrics for a complete list of available gadgets).

2. Access the set of gadgets available for each of the provided integrations (see Dashboard Integrations: Supported Products for a complete list of available integrations), select the one you want to add to the current dashboard.

3. Fill the configuration settings and click Add.

Open

Arrange gadgets

To arrange gadgets and resize them, you have to be in Edit mode.

To enter Edit mode, click on the Edit button in the right top navigation bar

• Drag and drop gadgets to a new location within the dashboard panel.

• Resize gadgets to increase or decrease to fit best in the dashboard layout.

See also