# 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](https://app.swarmia.com/settings/team/issues).

Note: We only sync non-private Linear teams by default. To enable syncing private teams as well, contact our support at <hello@swarmia.com>.

{% hint style="info" %}
**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.
{% endhint %}

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](/settings/team/issue-ownership.md).

<figure><img src="/files/gvssJ7lJKHKqXUGoWjZI" alt=""><figcaption><p>A team-based issue ownership assignment</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.swarmia.com/settings/integrations/issue-trackers/linear/linear-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.