> 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/bug-reports/send-to-apps/linear.md).

# Linear

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

Screendesk adds the capture link and debugging context automatically.

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

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

{% stepper %}
{% step %}

### Open integrations

In Screendesk, go to **Profile → Integrations**.
{% endstep %}

{% step %}

### Connect Linear

Find **Linear** and click **Connect**.

Approve Screendesk in Linear.
{% endstep %}

{% step %}

### Return to Screendesk

Linear now appears in your connected apps list.

You can also start this flow from **Send to app → Connect Linear**.
{% endstep %}
{% endstepper %}

### Create a Linear issue

{% stepper %}
{% step %}

### Open the item

Open the bug report or recording in Screendesk.

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 %}

### Review fields

Check the title and description.

Choose a **Team**.

Optionally add a project, parent issue, priority, assignee, status, and labels.
{% endstep %}

{% step %}

### Create the issue

Click **Create issue**.

Screendesk keeps the Linear issue link on the item, even if you disconnect later.
{% endstep %}
{% endstepper %}

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

<details>

<summary>Troubleshooting</summary>

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

</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/bug-reports/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.