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

# Linear

> Connect Plain to Linear to track issues and follow up with customers.

Connect your Linear workspace to Plain to track feature requests and bugs reported by customers. Link a Linear issue to any thread and get automatically prompted to follow up when the issue is completed or canceled.

<Frame>
  <img src="https://mintcdn.com/plain/esnLSCL6AbjPxXFS/public/images/linear.png?fit=max&auto=format&n=esnLSCL6AbjPxXFS&q=85&s=32f37f12a15b2d695dd77bd4fbe4d37d" alt="Linear in Plain" width="2400" height="1250" data-path="public/images/linear.png" />
</Frame>

## Setup

1. Go to **Settings → Linear**

2. Connect your Linear workspace

## Linking threads to Linear issues

Once connected, open any thread and use the **Thread links** panel in the sidebar or press <kbd>i</kbd> to create a new Linear issue or link an existing one.

When the Linear issue is completed or canceled, the thread automatically moves to **Close the Loop**.

### Linking Linear issues to threads via the API

You can also link a Linear issue to a Plain thread using the `createThreadLink` mutation, including from a machine user API key. This is useful for automation workflows that open Linear issues and want to surface them inside Plain without any manual steps.

For this to work, the Linear integration must be connected in **Settings → Linear** before you can link issues via the API. See the [**Linear integration guide**](/docs/product/integrations/linear) for setup steps.

Your machine user API key also needs:

* `threadLink:create`

* `threadLink:read`

## Linear templates

If you've created issue templates in Linear, you can choose which template to use each time you create a new issue from Plain.

## Customer requests

If your Linear workspace supports Customer Requests, Plain creates a Customer and a Customer Request when linking a thread to a Linear issue.

## Troubleshooting

### Status updates not syncing to Plain

If Linear issue status changes are not updating in Plain. For example, a thread does not move to **Close the Loop** when the linked issue is marked Done. Check whether a Team filter is restricting the Plain integration in Linear's Application settings.

In Linear, go to **Settings → API → Applications → Plain** and check the team access configuration. If the integration is scoped to specific teams, issues belonging to other teams will not send webhook events to Plain, meaning their status changes will be silently skipped.

Set the integration to allow **All teams** to ensure status updates sync for issues across your entire Linear workspace.