# Linear

## Setting up the Linear integration

<details>

<summary>Step 1: Add the Linear app to your workspace</summary>

See [instructions for installing an app in your workspace.](https://docs.glue.ai/integrations-overview#steps-to-set-up-one-of-the-pre-built-integrations-in-your-glue-workspace)

</details>

<details>

<summary>Step 2: Authorize Linear</summary>

Each user will need to authorize access to their Linear account once. You will be prompted to authorize the first time you send a Linear link into a message after the app has been added to your workspace.

* Paste a Linear link into any message in Glue, and send the message.
* A prompt will appear asking you to connect Linear to Glue. Click **Connect**.
* A popup up with then appear asking you to authorize Glue to use Linear. Click **Authorize**.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2Fkgpe9MhPDhCK7q0erLNc%2FCleanShot%202025-08-14%20at%2011.39.53%402x.png?alt=media&#x26;token=fba049a5-7754-4317-b3ff-ed2834a705e4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2F8FpPE0Kw4B0cw1acdcJ6%2FCleanShot%202025-08-14%20at%2011.40.10%402x.png?alt=media&#x26;token=6cacbb69-5a5f-4c52-842c-d6d0b8302454" alt=""><figcaption></figcaption></figure>

* A browser pop-up will open, redirecting you to Linear. Depending on your browser, the messaging may vary slightly. If you're already logged into Linear, the authorization will complete automatically. If not, you'll be prompted to enter your Linear credentials to proceed.
* You will see a confirmation message once Linear is successfully connected.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2Ff2JmG6LeiG0Qz0DBGJBN%2FCleanShot%202025-08-14%20at%2011.40.35%402x.png?alt=media&#x26;token=a619d150-9f10-4509-872e-2c9788c3a42d" alt=""><figcaption></figcaption></figure>

</details>

## Linear Link Previews&#x20;

With this integration, Glue can unfurl Linear links, making it easy to see issue details, project information, and team context without leaving the conversation. Statuses will update in real time in these previews.

#### Auto-Subscribe to Linear Updates

When you share a Linear issue link in a thread, Glue automatically subscribes the thread to updates for that issue. Whenever the issue's status changes, a system message is posted to the thread so everyone stays in the loop — no manual setup required. Just send your link with the link preview, and the thread will be automatically suscribed to updates.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FJmKVcTJZz4xAiwx1diWY%2FCleanShot%202026-02-20%20at%2014.59.41%402x.png?alt=media&#x26;token=9c39e3cd-2b67-4172-9287-45bd63f322d1" alt=""><figcaption></figcaption></figure>

## Supported Resource Types&#x20;

| Resource Type | Preview Format                  | Example                                 |
| ------------- | ------------------------------- | --------------------------------------- |
| **Issues**    | `Issue • TEAM-123: Issue Title` | Issue • API-456: Fix authentication bug |
| **Projects**  | `Project • Project Name`        | Project • Q3 Mobile Redesign            |
| **Teams**     | `Team • Team Name`              | Team • Engineering                      |

#### Troubleshooting

<details>

<summary>I do not want my thread auto subscribed to app updates</summary>

* Just remove the link preview before sending and your thread will not be subscribed to updates.

</details>

<details>

<summary>App updates are not sending for a link I sent</summary>

* Make sure you include the rich link preview when you send the link to the thread. If you removed the link preview, the thread will not be subscribed.
* App updates are only supported in threads, not in other chat types.

</details>

<details>

<summary>How do I unsubscribe my thread from an app update</summary>

* Open the thread resource sidebar
* Locate the shared link resource and click the 3 dot menu
* Click "Stop updates"&#x20;

</details>