Skip to main content

Setup

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

Overview

Connect Jira to create bug tickets from test failures. You can choose which project to send tickets to, along with details such as priority and assignee. Paste a Jira ticket link into Spur AI and ask it to draft tests from the requirements and attached images.

Permissions

When you authorize the integration, Spur requests the following Jira OAuth scopes. Each one maps directly to a feature of the integration:
Spur writes to your Jira workspace only to create tickets: when you create one from a test result, or when Auto-Create Jira Tickets is on. It never modifies your Jira configuration or deletes data on its own.

Set your defaults

Once connected, click Settings on the Jira card to open Jira Settings. Select a Default Project and a Default Issue Type. Under Required fields & defaults, select which fields a new ticket requires and the value each field opens with.

Auto-create tickets

Turn on Auto-Create Jira Tickets to have Spur create a Jira ticket automatically when a test finishes. Turning it on selects both When a test fails and When a test passes. Clear When a test passes if you only want tickets for failures. Auto-create needs a default project. Click Save Changes to apply your settings.

Creating a ticket manually from a test failure

1

Review a test and initiate a bug report

After reviewing a test run, open the Share menu and click Jira under Create a Ticket to open the Jira ticket creation modal:

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

2

Jira ticket creation modal

The modal opens with pre-populated information from the test failure:
Jira ticket creation modal with auto-generated content

Jira ticket 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
  • Project: The default project, if chosen in the Integrations page.
3

Customize ticket details

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

Customizing ticket details with additional information

Customization Options:
  • Assignee: Set who should handle the ticket
  • Priority: Set the urgency of the bug.
  • Due Date: When will this ticket be considered overdue?
4

Submit and track

Click Create Ticket. Spur files the ticket in Jira and links it to the test run.

Viewing and syncing linked tickets

Once a Jira ticket is linked to a test, Spur displays it in the test’s share panel with live status information pulled directly from Jira.

Status pill

Each linked ticket shows a status pill reflecting its current Jira workflow state — for example, Open, In Progress, or Done. The status is displayed alongside the ticket key so you can see the current state at a glance without leaving Spur.

Syncing ticket data

Spur refreshes linked tickets when you open the panel. Click Sync above the list to pull the latest information from Jira for every linked ticket. Syncing updates:
  • Title — Current ticket summary
  • Status — Current workflow state
  • Assignee — Current ticket owner
  • Priority — Current ticket priority
This is useful when a ticket has been updated in Jira since it was first linked—for example, if it has been reassigned, triaged, or resolved.

Troubleshooting

Common issues

Spur lost access to Jira:
  • Jira rejected Spur’s stored token. Click Reconnect on the Jira card on the Integrations page. Your settings are kept.
If fields are missing:
  • Your integration permissions may not be set properly. Try reintegrating from the Integrations page.
Ticket Creation Failures:
  • Confirm you have chosen a proper project and issue type
  • Check required field configurations
Custom Required Fields:
  • Fields your Jira project requires appear in the ticket creation modal, marked with an asterisk. Set the value each one opens with under Required fields & defaults in Jira Settings. If a required field still blocks ticket creation, contact the Spur team.