Browse documentation

Filter Tabs / Docs / Using the gadget

Using the gadget

Last updated 11/11/2026

Once the gadget is set up, everyone who can view the dashboard sees the tabs - with counts and results based on their own Jira permissions.

Day to day

  1. Read the counts. Each tab label shows the number of matching work items: exact up to 999, then compact ("1.2k", "12k", "1.2M"). While counts load the label shows "(…)"; "(!)" means that tab has a problem - open it to see why.
  2. Click a tab to list its work items in the table.
  3. Open a work item by clicking its key. Status shows as a coloured lozenge (grey = to do, blue = in progress, green = done). Dates are shown as DD/MM/YYYY.
  4. Page through results with Previous / Next under the table.
  5. See the full list with Open in search, which opens the tab's query in Jira search, where you can sort, export or bulk-change.
  6. Come back later. The gadget remembers the last tab you opened on this dashboard, in your browser only. Other people see their own last tab.

Keeping it current

  • Counts and results refresh every time the dashboard loads or you refresh the page.
  • If the gadget has Auto-refresh on, it also refreshes every 15, 30 or 60 minutes while the dashboard is open.

Different viewers, different results

Because every search runs as the viewer, two people can see different counts on the same tab - each sees only the work items they are allowed to see. If a tab uses a saved filter that is not shared with a viewer, that tab tells them so and the other tabs keep working.