Tools Connect: Linear (Beta)

First, in Linear, enable the audit history checkbox in Linear for full parity with Jira’s behavior. Without it, data sync still works but activity-level data will be inaccurate. It’s under “Other” at the bottom of the team page in settings.
Go to Tools from the organization dropdown.

Search for Linear, enter your API key, and click “ADD TOOL” to make the connection.

That’s all you have to do. We’ll start pulling data that night and you should see data in the morning.

Functionality Overview

Available now / working in production today:
- Metrics and WIT function as expected.
- Several special Linear parent types are enabled:
  - Team parent
  - Label
  - Label group parent
- Advanced filters and chart settings/axis groupings are also functional.
- Label groups are a new concept unique to Linear:
  - A label group aggregates multiple labels (e.g., a “color” label group might contain “red,” “yellow,” “green”).
  - Selecting the group in reports shows all items tagged with any of those labels (not grouped visually by label).
- Teams are also unique in Linear
  - They behave similar to a “project” in Jira

UI updates are the final step needed for complete functionality (the backend is ready).
- This enables the user to select the Linear-specific concepts such as Label Groups and Teams
Projects and Cycles are not yet covered:
- Cycles are Linear’s version of sprints.
- Projects act as a middle layer between issues and initiatives — similar to Jira epics, but can pull issues from multiple teams.
- Initiatives group multiple projects (similar conceptually to Jira initiatives).
Team nesting
- While we have teams working today as parent objects, there may be some nuances to how the data needs to be presented when teams are nested. It sounds like this is similar to ADO’s concepts of teams and area paths.