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

# Linear

> Learn how to use Tunnel with Linear

## Overview

The Linear integration allows you to create issues in Linear from Tunnel comments. You can also set default issue properties and automatically create issues in Linear with every comment.

## Configuration

You can configure the Linear integration in the [Tunnel Dashboard](https://tunnel.dev/redirect-to/default) by navigating to **Settings > Profile** and scrolling to the **Integrations** section.

### Connect Linear

Go to the [Tunnel Dashboard](https://tunnel.dev/settings/integrations). Click **Connect** to connect your Linear organization.

<Frame>
  <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/organization-settings.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=1ae61e23117c54f3e08ed7d63fa11351" width="1719" height="1073" data-path="assets/screenshots/integrations/linear/organization-settings.png" />
</Frame>

## Create issues

### Manually

With your Linear account connected, you can create issues in Linear from Tunnel comments.

<Steps>
  <Step title="Open the integrations dropdown menu">
    To attach a Linear issue to a comment, open the integrations dropdown menu from the **Create** button. Select **Create issue** in the Linear row.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/integrations-dropdown.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=2d682da0586543be7bb2655b57f6ac98" width="417" height="186" data-path="assets/screenshots/integrations/integrations-dropdown.png" />
    </Frame>
  </Step>

  <Step title="Set issue properties">
    Set the team, project, status, labels, assignee, and priority for the issue.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/linear-ticket-properties.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=95989f71b14de878eed9200ba9c42fb7" width="540" height="603" data-path="assets/screenshots/integrations/linear/linear-ticket-properties.png" />
    </Frame>
  </Step>

  <Step title="Submit the comment to create the issue">
    When you submit the comment, the issue will be created in Linear and a link to the issue will be added to the comment.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/linear-ticket.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=0673b7c7bf92c66822d8290e9594fe10" width="1279" height="869" data-path="assets/screenshots/integrations/linear/linear-ticket.png" />
    </Frame>
  </Step>
</Steps>

### Automatically

You can also set default issue properties and automatically create issues in Linear with every comment.

<Steps>
  <Step title="Add default issue properties">
    Go to the [Tunnel Dashboard](https://tunnel.dev/redirect-to/default) and navigate to **Settings > Profile**. Scroll to the **Integrations** section and click **Manage** in the **Linear** row.

    From here, you can set a default Linear team, and then set default values for project, status, assignee, and priority. You can also set default labels.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/default-settings.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=e363f71f78c417837e63cfd78b6351b9" width="1264" height="868" data-path="assets/screenshots/integrations/linear/default-settings.png" />
    </Frame>
  </Step>

  <Step title="(Optional) Turn on automatic issue creation">
    In your default Linear settings, you also have the option to turn on automatic issue creation. This will create a new issue in Linear for every you create comment in Tunnel.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/automatic-screenshot-creation.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=0751fd2f8044b7b9345d836899c870e8" width="1264" height="868" data-path="assets/screenshots/integrations/linear/automatic-screenshot-creation.png" />
    </Frame>
  </Step>

  <Step title="Create an issue">
    With your default settings configured, you can easily create an issue in Linear from a comment. To attach a Linear issue to a comment, open the integrations dropdown menu from the **Create** button. Select **Create issue** in the Linear row.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/integrations-dropdown.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=2d682da0586543be7bb2655b57f6ac98" width="417" height="186" data-path="assets/screenshots/integrations/integrations-dropdown.png" />
    </Frame>

    When you submit the comment, the issue will be created in Linear with your default settings and a link to the issue will be added to the comment.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/linear-ticket.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=0673b7c7bf92c66822d8290e9594fe10" width="1279" height="869" data-path="assets/screenshots/integrations/linear/linear-ticket.png" />
    </Frame>

    If you have automatic issue creation turned on, you'll see the Linear icon at the bottom of comment box. You can click it to override your default settings and create an issue with custom properties. Otherwise, an issue will be created with your default settings when you submit the comment.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/linear/linear-icon.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=48c506b73e721a954f301b0440a1bc5e" width="409" height="141" data-path="assets/screenshots/integrations/linear/linear-icon.png" />
    </Frame>
  </Step>
</Steps>
