Connecting Gadgets

A Dynamic Filter Controller only works when other gadgets are connected to it. This page explains how to connect Custom Charts and Issue Lists to the controller.

How connections work

Each DFC has a Reference ID - a unique identifier shown in the controller's header. When you configure a Custom Chart or Issue List and choose "Dynamic Filter Controller" as its data source, you select which DFC to connect to using this ID.

Once connected, the gadget stops using its own data source. Instead, it uses whatever the DFC returns based on the current filter state.

How to connect a gadget

1. Open the Custom Chart or Issue List gadget in edit mode
2. In the Data Source section, select Dynamic Filter Controller
3. A dropdown appears listing all DFCs on the same Jira dashboard
4. Select your controller (identified by its Reference ID or label)
5. Save the gadget

The gadget is now connected. When users change filters on the DFC, this gadget updates in real time.

Verifying connections

To see which gadgets are connected to a DFC:

1. View the DFC gadget (not edit mode)
2. Click Show Connected Charts

All connected gadgets on the dashboard are highlighted.

Connecting multiple gadgets

You can connect as many gadgets as needed to a single DFC. One filter bar can control every chart and table on the dashboard at once.

Disconnecting a gadget

1. Open the gadget in edit mode
2. Change the Data Source from "Dynamic Filter Controller" back to "Projects", "Saved Filter", or "Custom JQL"
3. Configure the new data source
4. Save

Common connection checklist