Linear

New comments become issues. Status syncs both ways.

Connect Linear

1

Open settings

Go to your dashboard and click Settings in the sidebar.

2

Connect your workspace

Click Connect Linear. Approve access in Linear. Lay requests read, write, and issue creation scopes.

i
One Linear workspace maps to one Lay account. If another Lay account already connected that workspace, disconnect it there first (or sign in with that account).
>
You can disconnect and reconnect from Settings at any time. Disconnecting cleans up webhooks and revokes the token. On reconnect, Lay recreates the webhook, including reclaiming an orphaned one.
3

Pick a team per project

Open a project. Turn Linear on and pick which team receives issues.

i
New projects auto-enable Linear with your first team if you have an active connection.

How sync works

CommentLayLinear issuesync

→ New comments create issues

← Status changes in Linear update your dashboard

Comment to issue

A root comment on a project with Linear on creates an issue. The issue gets:

  • Title. First line of the comment (max 80 characters).
  • Description. Comment text, author, page URL, element selector.
  • Screenshot. Annotated screenshot in the issue body.
  • Developer triage. Severity, affected systems, suggested response, when enriched.
i
Replies to a comment become comments on the Linear issue.

Status sync

DirectionTriggerResult
Dashboard → LinearResolve or archive a commentIssue moves to Done
Linear → DashboardComplete or cancel an issueComment marked resolved
Reopen an issueComment reopened

Status sync is bidirectional. Each direction uses a separate code path.

Configuration

Multiple projects

Each project can target a different Linear team. Open a project in the dashboard, toggle Linear on, and pick the team from the dropdown.

Disconnecting

Disconnecting Linear from Settings removes:

  • The OAuth connection and tokens
  • All project configurations
  • The link between comments and issues

Linear issues are not deleted. They stay in your Linear workspace.

!
Reconnecting creates a fresh connection. Previously synced comments won't re-link to their old issues.

Having issues? See Troubleshooting.