# Source: https://jam.dev/docs/integrations/linear.md

# Linear

{% embed url="<https://youtu.be/3oODiEiD8n0>" %}

You can connect Linear and Jam in order to instantly create Linear tickets right from Jam's browser extension. Every Linear ticket you create with Jam automatically includes:

* Console logs&#x20;
* Fully inspectable network requests&#x20;
* URL, timestamp and country&#x20;
* Device, OS, Browser&#x20;
* Viewport size&#x20;
* Network speed&#x20;

That way, it's perfect for engineers to help them debug issues faster.

You can configure all the relevant Linear fields right from Jam – like assignee, labels, priority and more. Our goal is to make you 20x faster at logging bugs to Linear.

## How to use Jam + Linear

1. First, you'll need to make sure you have Jam installed in your browser. Follow our Jam getting started guide here if you haven't downloaded and setup Jam yet:

{% content-ref url="../get-started/getting-started" %}
[getting-started](https://jam.dev/docs/get-started/getting-started)
{% endcontent-ref %}

2. Next, capture your bug with Jam.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FJm06A238yDNnQf2cM2eJ%2Flinear-1.gif?alt=media&#x26;token=464ca04d-8032-4b7a-b2f5-fb364ad5690b" alt="" width="375"><figcaption></figcaption></figure></div>
3. In the Jam extension, you will have the option to choose where Jam sends your screen capture to. Click on "Link you can share" and change it to Linear.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FGLfZ18EaCzuDd9loWYsb%2Flinear-2.gif?alt=media&#x26;token=8c8b72f0-b766-4b37-9e78-afeb699290cb" alt="" width="375"><figcaption></figcaption></figure></div>
4. Jam will guide you through authenticating with Linear.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FupYZC3qr30GoNiPXtFP2%2Flinear-3.gif?alt=media&#x26;token=1b3228ea-6ba3-46f2-9512-01a418bd7a9c" alt="" width="375"><figcaption></figcaption></figure></div>
5. Once Jam is connected to Linear, you will be able to setup your Linear ticket right from Jam. Choose the assignees, labels, priority, project, etc., right from Jam. <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FlEX9S9xDhn1ZosiZJJYf%2Flinear-4.gif?alt=media&#x26;token=179104f5-80f8-4c04-b4c2-d94184152019" alt="" width="375"><figcaption></figcaption></figure></div>
6. Pro tip: you can click "Edit fields" to manage which fields from Linear are shown in Jam:<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FMPEItdx1qKxGPVB8EqVj%2Fedit-fields.gif?alt=media&#x26;token=7849e5ad-75c6-430f-9f25-dbb461112543" alt="" width="375"><figcaption></figcaption></figure></div>
7. Click "Create issue" and once Jam creates your Linear ticket, it will automatically open in a new tab.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FJkOMrAW8Dbb9nTPqLfeC%2Flinear-5.gif?alt=media&#x26;token=18f06a9b-5a6c-4af2-b733-0588662ba1fc" alt="" width="375"><figcaption></figcaption></figure></div>

## How to send existing Jams to Linear

You can automatically create Linear tickets from existing Jams – in just 2 clicks.

*Note: You must be logged into Jam to use this feature. Logged out users will not see this option.*

1. Open up the Jam you want to convert to a Linear ticket.
2. Click "Send to App" and select Linear.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FsdUZtJSy1NRhcThFFWIk%2Fsend-to-linear-1.gif?alt=media&#x26;token=d41804e2-021b-48d0-8af3-5db585199220" alt="" width="375"><figcaption></figcaption></figure></div>
3. If you have not used Jam + Linear before, it will first redirect you to log in with Linear.
4. Enter the details of your Linear ticket: title, assignee, priority, labels, etc.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FjxNDL4XTXJhM5zJ531KH%2Fsend-to-linear-2.gif?alt=media&#x26;token=397f180c-89a2-45bc-953a-1489a94a69ea" alt="" width="375"><figcaption></figcaption></figure></div>
5. Pro tip: you can click "Edit fields" to manage which fields from Linear are shown in Jam.
6. Click "Create issue" to create your Linear ticket.

## How to connect multiple Linear workspaces to Jam

Each Jam team workspace can connect to 1 Linear workspace. That means if you're working with multiple companies or clients where each one uses its own Linear workspace, you will need to create a new Jam team workspace for each company/client, and connect each Jam team workspace to the relevant Linear workspace for that company/client.

Here's how to create multiple Jam team workspaces and connect them to separate Linear workspaces:

1. Go to the Jam dashboard: [jam.dev](https://jam.dev)
2. Click "Invite Teammates" or "Add a Team" <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F1UIMx7obwBDvjUTs8ysJ%2Fteam-1.gif?alt=media&#x26;token=426fb51c-ce7b-43c2-806c-1d878fa3d516" alt="" width="316"><figcaption></figcaption></figure></div>
3. Jam will walk you through the steps of creating a team.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FjUlv1G9GMruXJkn4EBHd%2Fteam-2.gif?alt=media&#x26;token=64c0f45d-d123-488f-b01c-d5a934cd66b2" alt="" width="375"><figcaption></figcaption></figure></div>
4. Go to your newly created team settings. Click on "Connected Apps". Then click on "Linear". The Linear authentication flow will open in a new tab. Login to the Linear workspace you want to connect that team to.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FlYO5nsugwsOdcIAUrNy7%2Fteam-linear-3.gif?alt=media&#x26;token=af7fa9f1-9848-4890-a1c8-bcc8deb8f787" alt="" width="375"><figcaption></figcaption></figure></div>
5. After you are done connecting to Linear, you will be able to see which Linear workspace is connected to that Jam team workspace. If you need to swap which workspace is connected, you can simply disconnect the Linear connection from the Jam connected apps settings, and re-connect to the correct Linear workspace.\
   &#x20;

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2F68kUM2caxEXhttguBSXt%2Fwhich-linear.gif?alt=media&#x26;token=7ac6450e-56d9-48a7-a31a-0712483b278d" alt="" width="375"><figcaption></figcaption></figure></div>
6. Now, when you create Jams, you can choose which Jam team workspace (and thus, which Linear workspace) to send each Jam to.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FgWR4EOxP3y2xPFszZRZg%2Fchoose-linear.gif?alt=media&#x26;token=feed2f01-e880-4e40-8274-ed340cf6a405" alt="" width="375"><figcaption></figcaption></figure></div>
7. Repeat this process of creating a new Jam team workspace + connecting the corresponding Linear workspace for every Linear workspace you need to connect to Jam.\ <br>