> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Route follow-ups and on-call triage straight into Linear, assigned to the right person automatically.

Using Linear to track your team's tasks? Using Linear to *triage* your team's tasks?

This is how you can export [your incident to-dos](/post-incident/follow-ups) to Linear to keep everything centralized, *and* automatically assign tasks according to your [incident schedules](/on-call/building-schedules).

***

## What we can do with Linear

### Assign triage tickets automatically

If you use [On-call](https://incident.io/on-call) with incident.io, you can combine this with [Linear's Triage functionality](https://linear.app/docs/triage) to automatically action triage tasks to who is currently on call on your incident.io schedules.

### → Exporting follow-ups

1. **Export** [your incident follow-ups](/post-incident/follow-ups) to Linear;

2. **Sync the status of your tasks between Linear and incident.io**, so you can work in Linear without worrying about updating statuses manually in incident.io!

<img src="https://mintcdn.com/incidentio-18bb4170/xNiFNBm3xEqt2Wkw/images/help-centre/linear/screenshot-1.png?fit=max&auto=format&n=xNiFNBm3xEqt2Wkw&q=85&s=b9623872ddb1c7e31e4f255787f9465f" alt="A follow-up overflow menu on an incident, with Create or link a Linear issue" width="2880" height="1800" data-path="images/help-centre/linear/screenshot-1.png" />

3. **Export templates,** this enables you to pre-set values to fields that can be used when exporting follow-ups.

<img src="https://mintcdn.com/incidentio-18bb4170/iopR3BNEfSUPs05k/images/help-centre/linear/screenshot-3.png?fit=max&auto=format&n=iopR3BNEfSUPs05k&q=85&s=906d19dd6b07e41c48dba9158381cc04" alt="The Edit Linear export template modal, with Linear Team, Linear Project, Assignee and Labels fields" width="1472" height="1138" data-path="images/help-centre/linear/screenshot-3.png" />

4. **Auto-exports to Linear,** you can automate the export process of follow-ups based on certain incident criteria, such as severity, and specific custom fields such as responsible teams

... [get in touch](http://incident.io/community) to give us your wishlist!

Follow-ups can be Linear **projects** as well as issues. Set **Create as** to **Project** on an export template, or paste a project URL to connect an existing one.

### Create incident tickets in Linear

You can create incident tickets in Linear, keeping a record of your incidents alongside your team's other work. Incident status can be synced to the Linear ticket using expressions in your template configuration.

An incident ticket can be a project too. When it is, that incident's follow-ups are moved into the project as they're linked, so all of an incident's work lands in one place. A follow-up whose template already sets a project keeps that project.

***

## Setting Up

Adding Linear to incident.io is simple.

1. **Go to Settings >** [Integrations](https://app.incident.io/~/settings/integrations)

Search for Linear, click its card, and hit **Connect**.

<img src="https://mintcdn.com/incidentio-18bb4170/iopR3BNEfSUPs05k/images/help-centre/linear/screenshot-4.png?fit=max&auto=format&n=iopR3BNEfSUPs05k&q=85&s=b2b90113acc01df92fa222c66c937c76" alt="The Integrations page in Settings with the Linear card and its Install button highlighted" width="1476" height="1133" data-path="images/help-centre/linear/screenshot-4.png" />

2. **Log into Linear**

*We currently only support one single Linear workspace*.

<img src="https://mintcdn.com/incidentio-18bb4170/iopR3BNEfSUPs05k/images/help-centre/linear/screenshot-5.png?fit=max&auto=format&n=iopR3BNEfSUPs05k&q=85&s=5513654f15252b35157a951b9267145d" alt="Linear's Log in to Linear page, offering Continue with Google and Continue with email" width="1224" height="1146" data-path="images/help-centre/linear/screenshot-5.png" />

3. **Enable a Triage action for your team on Linear**

In `linear.app/settings/teams/your-team/triage`, select `Notify` or `Assign` as a Triage action and click **Use schedule** to pick which incident.io schedule you want to automatically use.

<img src="https://mintcdn.com/incidentio-18bb4170/iopR3BNEfSUPs05k/images/help-centre/linear/screenshot-6.png?fit=max&auto=format&n=iopR3BNEfSUPs05k&q=85&s=5f4768ebe626c526d50bd1c19974937b" alt="Linear's Triage settings, with a picker listing incident.io schedules to assign new issues to" width="1664" height="1612" data-path="images/help-centre/linear/screenshot-6.png" />

That's it!

## FAQs

<AccordionGroup>
  <Accordion title="What follow-up data is synced to and from Linear?">
    * Status, Title, Description, Priority, Labels, and Assignee will all go from Linear to incident.

    * The Title and Description fields will go from incident to Linear.

    * Cancelling a Linear issue marks the follow-up as **not doing**, rather than completing it.
  </Accordion>

  <Accordion title="What schedule data is synced to Linear?">
    * Schedule name and times for the next 5 weeks will go from incident to Linear.
  </Accordion>

  <Accordion title="What if I have multiple rotas in incident.io, who will be assigned to the triage tickets in Linear?">
    * Linear will assign the person which comes from the first rota that is active
    * Example: If you have a rota 9am-5pm and a rota 5pm-12am, then we'll return whoever is on shift for each of those. But if you have a first rota that's 24/7, the person on that will always be assigned to the Linear triage tickets.
  </Accordion>
</AccordionGroup>
