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

# Linear

> Create a Linear issue from a CostGraph anomaly or recommendation

Turn an anomaly or a recommendation into a Linear issue in one step. The issue carries the cost detail and a link back to CostGraph. The CostGraph page then shows **Open ENG-123** for that issue.

## Before you begin

* A CostGraph organization owner or admin to connect Linear.
* A Linear account that can create issues in the teams you want to use.

## Connect Linear

<Steps>
  <Step title="Open the Linear card">
    In CostGraph, go to **Settings > Integrations**, open the **Ticketing** section, and select **Linear**. Click **Connect**.
  </Step>

  <Step title="Approve on Linear">
    Linear asks you to let CostGraph read your teams and create issues. Pick the Linear workspace to connect, then click **Authorize**. Linear returns you to CostGraph.
  </Step>

  <Step title="Choose teams">
    Select the teams people may create issues in, then click **Save**. To change the list later, click **Choose where tickets go** on the card. CostGraph only creates issues in these teams.
  </Step>
</Steps>

To change the list later, open the Linear card and edit the teams.

## Create an issue

1. Open an anomaly or a recommendation.
2. Click **Create ticket** and select **Linear**.
3. Choose the team for the issue. CostGraph creates it and shows **Open ENG-123**.

Each anomaly or recommendation has at most one Linear issue. Choosing **Linear** again opens the existing issue instead of creating another one.

## Reconnect

If CostGraph loses access to Linear, organization owners and admins get an email, and the Linear card shows **Reconnect**. Click **Reconnect** and approve on Linear again. Existing issue links keep working.

## Disconnect

On the Linear card, click **Choose where tickets go**, then **Disconnect**. People can no longer create Linear issues from CostGraph. Issues already created stay in Linear.

## Self-hosted deployments

Linear isn't available on self-hosted deployments. Use [GitHub issues](/costgraph/integrations/github-issues) instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.