# Linear

## Linear + Multitudes Integration Benefits

* Get visibility over velocity and spread of work with  [`Types of Work`](/metrics-and-definitions/process-metrics/value-delivery/types-of-work.md) insights
* See the balance between [`Feature and Maintenance work` ](/metrics-and-definitions/process-metrics/value-delivery/feature-vs-maintenance-work.md) 

## How it works

Issue data from Linear will be sent to Multitudes. This data is then processed by our data pipelines and shown in the Multitudes app as actionable insights around [`Value Delivery`](/metrics-and-definitions/process-metrics/value-delivery.md). The data can be viewed by either Issue count or Story Points, depending on your ways of working, and categorised based on labels or projects (see [Customize Work Categories](https://docs.multitudes.com/configuration-and-setup/customize-work-categories#how-to-customize-work-completed)).

## Requirements

In order to install this integration, you must have both:

* Owner or Manager level [permissions](/configuration-and-setup/permissions-and-roles.md) on Multitudes, and
* Admin role in Linear 

## How to install

On the Multitudes app, go to the [Integrations page](https://app.multitudes.co/teamSettings/integrations) (from the menu, find Account, click Settings, then click the Integrations tab across the top). Find the card that says Linear in the top Integrations section and click ‘Connect’ at top right.

1. After you click 'Connect' on the Linear card on the Integrations page, on the resulting pop-up click ‘Continue to set up Linear’

   <figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/646d401ba6b247aae816bb7a_1.png" alt=""><figcaption></figcaption></figure>
2. This opens a new page, click 'Authorize Multitudes'

   <figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/646d401a9089bf527ff2a6f8_2.png" alt=""><figcaption></figcaption></figure>
3. Now, you should be brought back to our app, where you’ll see a pop-up asking you to link Linear users with Multitudes users. This will determine whose Linear data we know to show in Multitudes, so it's important to complete this step. [Learn more about user linking](/configuration-and-setup/user-linking.md).
4. Lastly, you’ll see a success message in the pop-up!

   <figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/646d401ab71e936f00aed908_4.png" alt=""><figcaption></figcaption></figure>

## Linear integration stopped working?

Due to Linear's authentication system, the integration will stop working if the team member who originally set up the connection leaves your organization.

If your integration stops working, you can force the reinstall by following this link: <https://app.multitudes.co/linear/connect>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multitudes.com/integrations/linear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.