Frequently asked questions
Straight answers, including what the app cannot do.
Why can't I use the Team field in Jira dashboard gadgets?
Jira's native gadgets (Pie Chart, Issue Statistics, Two Dimensional Filter Statistics) do not list the Atlassian Team field as a statistic type, and JQL cannot order by it. Atlassian tracks this as JRACLOUD-87808 and JRACLOUD-87800, open since 2020. TeamLens adds a Team Statistics gadget that groups any JQL filter by team.
How do I search Jira issues by team name instead of team id?
Install TeamLens and use issue in teamIn("Team Name"). Native JQL requires the team's UUID. teamIn() resolves names, including a trailing * wildcard, and supports not in.
How do I find Jira issues with no team assigned?
Use issue in noTeam(). Combine with statusCategory != Done to see only open work that no team owns.
How do I see workload per team in Jira?
Open a project's Team reports tab, or Apps, TeamLens Team reports for several projects. The Workload report shows per Atlassian Team the To do, In progress and recently Done counts, blocked and overdue issues, open story points and team size, with a drill-down to the issues. Jira's native gadgets group by assignee, not by team.
How do I see cross-team dependencies in Jira?
The Dependencies report reads the issue links in your scope and keeps the ones whose two ends belong to different teams: a who-waits-on-whom matrix, per-team waiting and blocking counts, and a list with overdue blockers first. Pick the link type; Blocks is the default.
How is team velocity different from Jira's Velocity Chart?
Jira's Velocity Chart is per board and does not know which team did the work. The TeamLens Velocity report groups completed and committed work by the Team field across every board in the scope over the last 4 to 12 closed sprints, with the average, trend and completed-over-committed per team. It is computed from each issue's Sprint field, so it needs no board setup but does not model mid-sprint scope changes.
Does TeamLens work with Jira Plans (Advanced Roadmaps)?
Yes. Plans writes the same native Team field that TeamLens reads, so the gadget and JQL functions reflect your Plan's team assignments.
Does it work in Jira Service Management queues?
Yes. teamIn() and noTeam() work in queue JQL. A myTeams() function for per-agent queues is planned and depends on an Atlassian API change.
Can TeamLens show who is in a team, or notify a whole team?
Not yet. Atlassian's Teams REST API returns team members only to a human's API token (basic auth, organization scope); it is not available to an app's own Forge or Connect auth context, so no Marketplace app can read member lists on its own (app access is tracked as JRACLOUD-92072). TeamLens shows team size. Member-level features ship when apps can call that API.
Does any data leave my Atlassian site?
No. TeamLens runs entirely on Atlassian's Forge platform with no external servers. It stores only a team directory (team ids and names) in Atlassian's Forge storage for the teamIn() JQL function, and reads issues as the person viewing them, so Jira permissions are always respected.
How much does TeamLens cost?
Free for sites with up to 10 users. Above that, USD 1 per user per month with volume discounts, billed by Atlassian with your Jira subscription. A 30-day free trial starts automatically.
Which Jira products does it support?
Jira Cloud: Jira Software, Jira Work Management and Jira Service Management, in both team-managed and company-managed projects. It is not available for Jira Data Center.
Known limitation. Apps cannot read Atlassian Team membership from their own auth context yet (the Teams API answers only a human's API token). We publish exactly what that blocks on the limitations page and will ship member-level features the day Atlassian opens the API.