Linear

Create Linear issues from recordings with team, project, and workflow fields.

Create a Linear issue from any recording you can edit. The issue includes a link back to Screendesk and the context your team needs to investigate fast.

This page covers the manual Send to app action. Folder automations are separate: automations create issues automatically when recordings enter a folder.

Before you start

• Connect Linear from Profile > Integrations.
• Make sure your Linear account can access the target team.
• Make sure you can edit the recording.

Connect Linear

Linear is connected from your personal Screendesk profile. Each teammate sends issues with their own Linear account.

1. In Screendesk, open Profile > Integrations.
2. Find Linear.
3. Click Connect.
4. Approve Screendesk on Linear's authorization screen.
5. Return to Screendesk. Linear now appears in the connected apps list.

If you open the Send to app menu before connecting Linear, choose Connect Linear from the menu and complete the same authorization flow.

Create the issue

1

Open the recording

Open the recording in Screendesk. Then 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

Fill in the fields

Review the title and description. Choose a Team. Then add any optional fields you need.

4

Create the issue

Click Create issue. Screendesk adds the Linear issue link to the recording.

The issue link stays visible even if Linear is disconnected 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 adds

Every issue includes:

• A direct link to the recording
• The source website URL, when available
• Device and browser information
• The recording timestamp in UTC
• A link back to developer information in Screendesk

Anything you type in the description appears before 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 preferences are saved to your Linear connection and apply the next time you send to Linear.

Permissions

You must be able to edit the recording to use Send to app. Watch-only users cannot connect personal app accounts or send recordings to Linear.

Workspace admins can remove Linear from the workspace from Profile > Integrations. This disconnects Linear for everyone in the workspace, but existing Linear issue links stay on their Screendesk recordings.

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