For the complete documentation index, see llms.txt. This page is also available as Markdown.

Linear

Create Linear issues from Screendesk with captured context and app fields.

Send any bug report or recording to Linear in a few clicks.

Screendesk adds the capture link and debugging context automatically.

This page covers the manual Send to app action. Folder automations create issues automatically when recordings or bug reports enter a folder.

Before you start

  • You need edit access on the Screendesk item.

  • Connect Linear from Profile → Integrations.

  • Each teammate uses their own Linear account.

Connect Linear

1

Open integrations

In Screendesk, go to Profile → Integrations.

2

Connect Linear

Find Linear and click Connect.

Approve Screendesk in Linear.

3

Return to Screendesk

Linear now appears in your connected apps list.

You can also start this flow from Send to app → Connect Linear.

Create a Linear issue

1

Open the item

Open the bug report or recording in Screendesk.

Click Send to app.

2

Choose Linear

Select Linear issue.

If Linear is your only connected app, the main button may say Send to Linear.

3

Review fields

Check the title and description.

Choose a Team.

Optionally add a project, parent issue, priority, assignee, status, and labels.

4

Create the issue

Click Create issue.

Screendesk keeps the Linear issue link on the item, even if you disconnect later.

Available fields

Field
Required
Notes

Title

Yes

Used as the Linear issue title.

Description

Yes

Your notes are added above the Screendesk context.

Team

Yes

Determines where the issue is created.

Project

No

Available projects update after you choose a team.

Parent issue

No

Link the new issue under an existing Linear issue.

Priority

No

Maps to Linear priority values.

Assignee

No

Available members update after you choose a team.

Status

No

Available workflow statuses update after you choose a team.

Labels

No

Available labels update after you choose a team.

What Screendesk sends

  • A direct link to the bug report or recording

  • The source website URL, when available

  • Device and browser details

  • The capture timestamp in UTC

  • A link to developer information in Screendesk

Anything you add in the description goes above the generated Screendesk context.

Customize the form

Click Edit fields in the Linear modal to show or hide optional fields.

Required fields stay visible.

Your field choices are saved for your Linear connection.

Permissions

  • You must be able to edit the bug report or recording.

  • Watch-only users cannot connect personal app accounts or send items to Linear.

  • Workspace admins can remove Linear from Profile → Integrations for the whole workspace. Existing issue links stay visible.

Troubleshooting

Linear is not in the Send to app menu

Open Profile → Integrations and connect Linear.

If the button is missing entirely, confirm that you can edit the bug report or recording.

Linear asks you to reconnect

Reconnect Linear from Profile → Integrations.

This can happen if Linear revokes the token or the connection expires.

Teams, projects, members, statuses, or labels do not load

Reconnect Linear and make sure your Linear account has access to the workspace, team, and fields you want to use.

Last updated

Was this helpful?