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

# Linear

> Sync Rootly incidents to Linear issues for seamless issue tracking, follow-up management, and engineering context from incident response to delivery.

Rootly's Linear integration connects your incident workflow to Linear. When an incident is declared, a Linear issue is automatically created. As the incident progresses, the issue stays in sync. When resolved, the Linear issue moves to Done.

Follow-up action items become Linear sub-issues under the parent incident issue, keeping post-incident work organized in one place.

## What You Can Do

<CardGroup cols={2}>
  <Card title="Incidents → Linear Issues" icon="arrow-right">
    Automatically create a Linear issue when an incident is declared, with title, description, severity, and assignee populated from incident data
  </Card>

  <Card title="Action Items → Sub-Issues" icon="list-tree">
    Every follow-up action item created during an incident becomes a Linear sub-issue under the parent incident issue
  </Card>

  <Card title="Status Sync" icon="rotate">
    When an incident resolves in Rootly, the linked Linear issue automatically moves to Done
  </Card>

  <Card title="On-Call → Triage" icon="user-clock">
    Connect Rootly on-call schedules to Linear's Triage Responsibility so new issues auto-assign to whoever is on call
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Incident declared">
    An incident is created in Rootly, either manually or via an alert from PagerDuty, Datadog, or another source.
  </Step>

  <Step title="Workflow runs">
    Your configured workflow fires and creates a Linear issue in the specified team and project, with fields populated from incident data.
  </Step>

  <Step title="Issue linked">
    The Linear issue URL is automatically attached to the incident in Rootly. Teams can navigate between both systems.
  </Step>

  <Step title="Updates flow">
    As the incident progresses, action items become sub-issues. When the incident resolves, the Linear issue status updates automatically.
  </Step>
</Steps>

## Workflow Actions

| Action                      | Trigger                      | What It Does                                                               |
| --------------------------- | ---------------------------- | -------------------------------------------------------------------------- |
| **Create Linear Issue**     | Incident created             | Creates a new issue in your specified Linear team with incident details    |
| **Update Linear Issue**     | Incident updated or resolved | Changes the status, assignee, or other fields on the linked issue          |
| **Create Linear Sub-Issue** | Action item created          | Creates a sub-issue under the parent incident issue for follow-up tracking |

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="plug" href="/integrations/linear/installation">
    Connect your Linear workspace to Rootly via OAuth
  </Card>

  <Card title="Workflows" icon="diagram-project" href="/integrations/linear/workflows">
    Configure when and how Linear issues are created and updated
  </Card>
</CardGroup>