​
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 by navigating to Settings > Profile and scrolling to the Integrations section.

​
Connect Linear

Go to the Tunnel Dashboard. Click Connect to connect your Linear organization.

​
Create issues

​
Manually

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

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.
2

Set issue properties

Set the team, project, status, labels, assignee, and priority for the issue.
3

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.

​
Automatically

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

Add default issue properties

Go to the Tunnel Dashboard 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.
2

(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.
3

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.
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.
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.