Linear configuration

After connecting Linear, Swarmia automatically maps the issue types and statuses on Swarmia based on the Linear types and statuses. The only configuration you need to do is assign the right issues from your workspace to the corresponding Swarmia teams. e.g. Linear team(s) or labels.

Configure teams

To ensure we get the right issues for each team, we ask you to assign the Linear team (or teams) to the teams on Swarmia. This can be done for each team in Settings → Team → Issues.

Note: We only sync non-private Linear teams by default. To enable syncing private teams as well, contact our support at [email protected].

Tips for structuring work in Linear

Use projects in Linear for work that spans a longer period (weeks or months) but still has a limited scope. This way, you can use Work Log to see how your team is splitting their time between these projects. You can recognize some common patterns, like projects with only one person working on them, or projects that are not progressing due to other priorities. Use Working Agreements to help address these issues.

Add a Bug/Defect label to issues to treat them as bugs in Swarmia. Bugs are shown in their own lane in Work Log and Bug insights.

Assigning issue ownership for teams is an essential step, as only then will the Linear issues and related data be visible in Swarmia. Read more about issue ownership.

A team-based issue ownership assignment