Group Report for Jira

A Forge-powered dashboard gadget that visualizes Story workload by Group → Member, with instant drill-downs and optional chart views.

Contents

Overview
Key features
Install & add to dashboard
Configure (Edit screen)
Using the gadget
Permissions & security
Performance & limits
Troubleshooting & FAQ
Roadmap
Support

Overview

Group Report provides a compact, actionable view of Stories distributed across teams (Jira Groups) and individual members. It supports both an expandable table and multiple chart visualizations, so you can scan, drill down, and share insights quickly.

Mode: Table / Chart Charts: Stacked Bar, Radar, Polar Area Drill-down: Clickable status counts → JQL Filters: Groups, Project Categories Status badges with category colors

Key features

Two views: Table (Groups → Members → Tasks) and Charts (Stacked Bar, Radar, Polar Area).
Instant drill-down: Click a status counter to open a prebuilt JQL in Jira. Hover to see the exact JQL.
Expandable details: Expand a group to see members; expand a member to see their tasks (type icon, status badge, project, issue key + summary, open time).
Filters & segmentation: Multi-select Groups; quick toggle for Jira Project Categories.
Polished UX: sticky headers, row hover, subtle gridlines, compact spacing, consistent toolbar.
Permission-aware: Runs as the current user; you see only what you’re allowed to see.

Install & add to dashboard

Install the app from Atlassian Marketplace (or your internal Forge distribution).
Open a Jira dashboard → Add gadget → find Group Report → Add.
Click the gadget’s Edit to configure your groups (see below), then Save.

Configure (Edit screen)

On the gadget’s Edit screen:

Groups: search and select one or more Jira Groups (multi-select with chips and “select all”).
Save: your selection is stored in the gadget configuration for this dashboard.

Tip. You can add multiple gadget instances with different group sets to compare teams side-by-side.

Using the gadget

Toolbar

View: toggle between Table and Chart.
Chart type: when in Chart view, switch between Stacked Bar, Radar, or Polar Area.
Refresh: re-run the queries (useful after workflows or assignments change).

Filters

Groups filter: limit the table to specific groups.
Project Category: one-click chips to segment results by Jira project category.

Table mode

Rows list Groups. Expand a group to reveal Members.
Each member row shows status counters. Click any counter to open the matching JQL in Jira Search.
Expand a member to see their Tasks with:

Issue type icon & name

Status badge (with category color)

Project name

Key + summary link

Open time (Created→Resolved or Created→Now)

Chart mode

Stacked Bar: groups on X, stacked by status (great for volume comparisons).
Radar: statuses on axes, each group as a polygon (pattern/shape comparison).
Polar Area: total volume by status (proportion insight).

Permissions & security

Runs as the current user (asUser) and honors Jira permissions.
Read-only scopes (typical): read:jira-work, read:issue:jira, read:project:jira, read:user:jira, and related metadata scopes.
Data residency: no external services; data is fetched live from Jira Cloud.

Performance & limits

Uses /rest/api/3/search/jql (POST) with cursor pagination (nextPageToken).
Server response is mapped to a lightweight “slim” issue shape to minimize payload size.
Requests are batched to avoid Forge payload/timeout limits.

Troubleshooting

No data or partial data? Ensure the selected Groups exist and members have visible Stories. Check project permissions.
Links blocked in dev tunnel? Browser may sandbox the iframe during forge tunnel, preventing top navigation. In production deployment, links open in the Jira window.
Charts not rendering? Make sure chart.js is packaged with the static bundle (Marketplace build already includes it).

FAQ

Q: What gets counted in status bubbles?
A: Only Story issues that match the current Group/Category filter.

Q: Can I export data?
A: Not yet. See the Roadmap below (CSV/XLSX export).

Q: Does it show private issues?
A: No. Visibility strictly follows Jira permissions of the viewing user.

Roadmap

Exports: CSV/XLSX for table and chart data (with current filters).
Saved views & presets: quick recall of group/category/chart settings.
More charts: 100% stacked bar, treemap, trend lines (time series).
Time-in-status & lead/flow metrics: optional columns and chart overlays.
Snapshot sharing: copyable links and image/PDF export of charts.
Caching & background refresh: smarter reloading with gentle staleness.
I18n & theming: localization (EN/RU first), theme-aware styling.
Admin options: default group sets per dashboard or project space.

Support

Questions, ideas, or issues? Reach out to your app administrator or the development team. When reporting a problem, please include:

Screenshot and the Jira URL (redact sensitive data if needed)
Selected Groups and Project Categories
Browser + OS, and whether you’re using forge tunnel or a production deployment