> For the complete documentation index, see [llms.txt](https://docs.screendesk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.screendesk.io/request-screen-recording/send-to-apps/linear.md).

# Linear

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.

{% hint style="info" %}
This page covers the manual **Send to app** action. Folder automations are separate: automations create issues automatically when recordings enter a folder.
{% endhint %}

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

{% stepper %}
{% step %}

### Open the recording

Open the recording in Screendesk. Then click **Send to app**.
{% endstep %}

{% step %}

### Choose Linear

Select **Linear issue**. If Linear is your only connected app, the main button may say **Send to Linear**.
{% endstep %}

{% step %}

### Fill in the fields

Review the title and description. Choose a **Team**. Then add any optional fields you need.
{% endstep %}

{% step %}

### Create the issue

Click **Create issue**. Screendesk adds the Linear issue link to the recording.
{% endstep %}
{% endstepper %}

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

<details>

<summary>Linear is not in the Send to app menu</summary>

Open **Profile > Integrations** and connect Linear. If the button is missing entirely, confirm that you can edit the recording.

</details>

<details>

<summary>Linear asks you to reconnect</summary>

Reconnect Linear from **Profile > Integrations**. This can happen if Linear revokes the token or the connection expires.

</details>

<details>

<summary>Teams, projects, members, statuses, or labels do not load</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.screendesk.io/request-screen-recording/send-to-apps/linear.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.