# Linear

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjFmyReUsbJqDjHEAlW%2F-MjHBtEkz29C-YG2BZDu%2F-MjHDC9iwNEtdLwGM5QN%2Flinear.png?alt=media&#x26;token=c8260fe1-0a6f-4df5-b14a-b7e5f7fb4182" alt=""></div>

With our Linear integration, you can see Issues (of all statuses) alongside the releases they’re a part of, the code they’re related to, and the people who are working on them. With builds and crash info layered on top, everyone on your team gets the complete picture at their fingertips, saving you from the noise of answering the same kinds of questions over and over again on Slack. Additionally, when you create a bug ticket in Linear and label it for a given release, Runway will highlight it as pending work and can gate app submission until it’s addressed.

{% hint style="info" %}
**Welcome Linear users! New to Runway?**

Runway is mobile release management software that connects your existing project management, development, and performance monitoring tools together. This empowers you to see status and progress of all releases at-a-glance and to automate away a wide variety of release tasks both large and small.
{% endhint %}

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Linear**

* Find the **Linear** integration module under the **Project management** section
* Click the **Connect** button
* You’ll be taken through a standard [Linear app](https://developers.linear.app/docs/oauth/authentication) OAuth flow

{% hint style="warning" %}
You must be logged in as a Linear user in the workspace you want to attach.
{% endhint %}

{% hint style="warning" %}
This integration requires `admin`, `read`, and `write` scopes in order to allow certain automations, such as [Add missing labels or fix versions to tickets in project management tool](https://docs.runway.team/automations/types-of-automations#add-missing-labels-or-fix-versions-to-tickets-in-project-management-tool), to work.&#x20;
{% endhint %}

* Linear redirects you back to Runway, Runway presents a dialog:
  1. Select all the Linear teams you want to pull tickets from
  2. Select any additional columns that signify a “done” state for your tickets (Runway pre-selects any columns marked in Linear as “done” states)

### Add feature affiliations

* Specify the labels that Runway should use associate tickets with specific releases
* Pattern is tokenized with the release version, *e.g.* `ios-{version}`