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

# Linear

> Turn every Jam into a Linear issue with full technical context. Set assignees, labels, and priority without leaving the extension.

<iframe src="https://www.youtube.com/embed/3oODiEiD8n0" width="100%" height="400" allowFullScreen />

Connect Jam to Linear to turn every bug capture into a properly formatted Linear issue in one click. All the technical context engineers need is attached automatically, so you never have to fill in debug details by hand.

<Info>You need the Jam Chrome extension installed. See [Getting Started](/introduction) if you haven't set it up.</Info>

## What's included in every Linear issue

Every Linear issue created from Jam automatically includes:

* Console logs
* Fully inspectable network requests
* URL, timestamp, and country
* Device, OS, and browser
* Viewport size
* Network speed

<Tabs>
  <Tab title="Create a Linear issue from a new capture">
    <Steps>
      <Step title="Capture your bug">
        Use the Jam browser extension to capture your bug.
      </Step>

      <Step title="Select Linear as the destination">
        In the Jam extension, click **Link you can share** and change the destination to Linear.
      </Step>

      <Step title="Authenticate with Linear">
        Complete the Linear OAuth flow to connect your account.
      </Step>

      <Step title="Configure your Linear issue">
        Once connected, set up your issue from Jam: choose the assignees, labels, priority, project, and more.
      </Step>

      <Step title="Create the issue">
        Click **Create issue**. Jam creates the Linear ticket and opens it in a new tab.
      </Step>
    </Steps>

    <Tip>
      Click **Edit fields** during issue setup to manage which Linear fields are shown in the Jam extension. Remove fields you don't need to speed up your workflow.
    </Tip>
  </Tab>

  <Tab title="Send an existing Jam to Linear">
    Create a Linear issue from any Jam you've already captured in two clicks.

    <Note>
      You must be logged into Jam to use this feature. Logged-out users will not see the **Send to App** option.
    </Note>

    <Steps>
      <Step title="Open the Jam">
        Open the Jam you want to convert into a Linear issue.
      </Step>

      <Step title="Click Send to App">
        Click **Send to App** and select Linear.
      </Step>

      <Step title="Log in to Linear if prompted">
        If this is your first time using Jam + Linear, you'll be redirected to authenticate.
      </Step>

      <Step title="Fill in the issue details">
        Enter the title, assignee, priority, labels, and any other fields you need.
      </Step>

      <Step title="Create the issue">
        Click **Create issue** to send the Jam to Linear.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Connect multiple Linear workspaces">
    Each Jam workspace connects to one Linear workspace. To work with multiple Linear workspaces, for example across different clients or companies, create a separate Jam workspace for each one.

    <Steps>
      <Step title="Go to the Jam dashboard">
        Open [jam.dev](https://jam.dev).
      </Step>

      <Step title="Create a new workspace">
        Click **Invite Members** or **Add a Workspace** and follow the prompts.
      </Step>

      <Step title="Connect Linear">
        Go to [**Settings → Integrations**](https://jam.dev/s/settings/integrations) and click **Linear**. The Linear OAuth flow opens in a new tab. Log in to the Linear workspace you want to connect.
      </Step>

      <Step title="Confirm the connection">
        After connecting, you'll see which Linear workspace is linked to that Jam workspace. To swap workspaces, disconnect the Linear connection in [**Settings → Integrations**](https://jam.dev/s/settings/integrations) and reconnect to the correct one.
      </Step>

      <Step title="Choose the workspace when capturing">
        When you create Jams, select which Jam workspace (and therefore which Linear workspace) to send each Jam to.
      </Step>

      <Step title="Repeat for each Linear workspace">
        Repeat this process for every Linear workspace you need to connect.
      </Step>
    </Steps>
  </Tab>
</Tabs>