​
Setup

If you have not integrated Spur with Linear, follow the setup process here.

​
Overview

Connecting to our Linear integration allows you to easily create Bug Tickets. Choose between:
  1. Manually creating tickets from Test Results
    • Easily create detailed Bug Tickets from Spur Test Results, fitting into your team’s workflow easily
    • Choose which Project to send tickets to, as well as details such as Priority and Assignee
  2. Automatically create tickets on Test Completion
    • Set up rules for automatic ticket creation based on test outcomes
Recommended Practice: We recommend starting with manual selection for ticket creation, only moving to automatic after tests have been run a few times.

​
Creating a Ticket Manually from a Test Failure

1

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:

Bug report initiation showing the Share menu and the Create a Ticket options

2

Linear Issue Creation Modal

The modal opens with pre-populated information from the test failure:

Linear issue creation modal with auto-generated content

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

Customize Issue Details

Edit the title and description, if necessary. Choose additional issue details.

Customizing issue details with additional information

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
4

Submit and Track

Create the issue!

​
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

​
Support

Need help with your Linear integration? Contact our support team!