# Linear

### How to integrate test automation with Linear?

BugBug's Linear integration helps you turn failed tests into Linear issues without copying test details by hand.

Use this integration when your QA and development workflow is managed in Linear and you want failed BugBug runs to become actionable issues with links back to the test run.

Keep in mind that Linear integration is available on paid plans. More information about pricing can be found here: <https://bugbug.io/pricing/>

### Connect Linear with BugBug

1. Go to the **Integrations** page.
2. Find **Linear** on the integrations list.
3. Click **Manage**.
4. Click **Connect**.
5. Authorize BugBug in Linear.
6. After authorization, you will return to BugBug.

BugBug uses the connection to read available Linear teams and create issues in the team you choose.

### Create a Linear issue from a failed test

You can create Linear issues from failed test results in BugBug.

1. Open the failed test run.
2. Find the failed test or step that should become an issue.
3. Choose **Create Linear issue**.
4. Select the Linear team.
5. Edit the issue title if needed.
6. Confirm issue creation.

BugBug creates the Linear issue and stores the linked issue in the test run context, so your team can get back to the Linear issue from BugBug later.

BugBug does not automatically create Linear issues for every failed scheduled run. Create the issue when the failed run needs work in Linear.

### View or remove linked Linear issues

Linked Linear issues are shown in BugBug next to the related failed run, test, or step.

If an issue was created by mistake or no longer belongs to the run, you can remove the link from BugBug. Removing the link in BugBug does not delete the issue in Linear.


---

# Agent Instructions: 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:

```
GET https://docs.bugbug.io/integrations/linear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.