> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear Tickets

> Connect Spur with Linear for streamlined issue tracking and automated bug reporting.

## Setup

If you have not integrated Spur with Linear, follow the setup process [here](/analysing-tests/integrations/integrations).

## Overview

Connecting to our Linear integration allows you to create bug tickets directly from test failures. You can choose which team and project to send issues to, along with details such as priority, assignee, and labels.

## Creating a Ticket Manually from a Test Failure

<Steps>
  <Step title="Reviewing a Test and Initiating a Bug Report">
    After reviewing a test run, open the Share menu and click the "Create a Ticket" button to open the Linear issue creation modal:

    <Frame caption="Bug report initiation showing the Share menu and the Create a Ticket options">
      <img src="https://mintcdn.com/spur/nNuvmyM4s84IFvTw/images/Integrations/share.png?fit=max&auto=format&n=nNuvmyM4s84IFvTw&q=85&s=0896982aaf8882f14eb4f6cab7efb787" width="300px" data-path="images/Integrations/share.png" />
    </Frame>
  </Step>

  <Step title="Linear Issue Creation Modal">
    The modal opens with pre-populated information from the test failure:

    <Frame caption="Linear issue creation modal with auto-generated content">
      <img src="https://mintcdn.com/spur/nNuvmyM4s84IFvTw/images/Integrations/Linear/linear_full.png?fit=max&auto=format&n=nNuvmyM4s84IFvTw&q=85&s=7e53e9ac45e37b70a26deaa19a8c29d4" width="2224" height="1656" data-path="images/Integrations/Linear/linear_full.png" />
    </Frame>

    **Auto-Generated Fields:**

    * **Title**: Name of the Test
    * **Description**: Detailed bug report including:
      * Failure Reason
      * Reproduction steps
      * Test name and execution details
    * **Team**: The default team, if chosen in the Integrations page.
  </Step>

  <Step title="Customize Issue Details">
    Edit the title and description, if necessary. Choose additional issue details.

    <Frame caption="Customizing issue details with additional information">
      <img src="https://mintcdn.com/spur/nNuvmyM4s84IFvTw/images/Integrations/Linear/linear_additional.png?fit=max&auto=format&n=nNuvmyM4s84IFvTw&q=85&s=c51e9b094e073bfa5e8a33890e09ab61" width="300px" data-path="images/Integrations/Linear/linear_additional.png" />
    </Frame>

    **Customization Options:**

    * **Project**: Which project should this ticket be in? This is optional.
    * **Assignee**: Set who should handle the issue
    * **Priority**: What is the urgency of this bug?
    * **Labels**: Attach any labels that are allowed within the selected team.
    * **State**: Choose the current status of the issue
  </Step>

  <Step title="Submit and Track">
    Create the issue!
  </Step>
</Steps>

## Troubleshooting

### Common Issues

**If fields are missing:**

* Your integration permissions may not be set properly. Try reintegrating from the Integrations page.

**Issue Creation Failures:**

* Confirm you have chosen a proper team
* Check required field configurations

**Custom Required Fields:**

* If your Linear workspace has custom required fields, [contact the Spur team](/additional-resources/contact-us) for assistance with your integration setup.