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

# Jira Tickets

> Connect Spur with Jira for comprehensive test management and automated bug reporting.

## Setup

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

## Overview

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

## 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 Jira ticket 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="Jira Ticket Creation Modal">
    The modal opens with pre-populated information from the test failure:

    <Frame caption="Jira ticket creation modal with auto-generated content">
      <img src="https://mintcdn.com/spur/nNuvmyM4s84IFvTw/images/Integrations/Jira/jira_full.png?fit=max&auto=format&n=nNuvmyM4s84IFvTw&q=85&s=0ce55247cc93ed2ed52561a07d504198" alt="" width="2366" height="1706" data-path="images/Integrations/Jira/jira_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
    * **Project**: The default project, if chosen in the Integrations page.
  </Step>

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

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

    **Customization Options:**

    * **Assignee**: Set who should handle the ticket
    * **Priority**: What is the urgency of this bug?
    * **Due Date**: When will this ticket be considered overdue?
  </Step>

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

## Troubleshooting

### Common Issues

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

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