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

# How to integrate with Jira

> Connect QA Wolf to Jira to automatically create, sync, and close issue tickets from QA Wolf bug reports.

## Overview

* **Automatic issue handling.** Creates Jira issues automatically when new bug reports are generated in QA Wolf, keeping Jira up to date without manual entry.
  <Danger>
    Context added in Jira is not written back to QA Wolf.
  </Danger>
* **Synchronization.** Closing a bug report in QA Wolf will close the linked Jira ticket. QA Wolf also performs regular bug revalidations to ensure accuracy.
  <Danger>
    Closing a Jira ticket should automatically update QA Wolf. Contact us if that doesn't happen so we can help you troubleshoot.
  </Danger>
* **Test creation requests.** Add a **QA Wolf** label to a Jira ticket to automatically create a coverage request in QA Wolf.
* **Custom configuration.** Specify the project, assignee, and issue status. Currently, each integration setup supports one project, one assignee, and one status type.
* **Custom fields.** Add custom Jira fields to bug reports if your Jira project uses them. Custom fields apply globally across all tickets created through QA Wolf, not per workflow.

## Set up the integration

<Steps>
  <Step>
    Open the `Workspace name` dropdown and click **Workspace settings**.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-1.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=8e9e2f1b55c90e1e31372a1950c769b8" alt="" width="1232" height="506" data-path="images/integrate-your-issue-tracker/image-1.png" />
    </Frame>
  </Step>

  <Step>
    Navigate to **Integrations**.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-2.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=1ebecd2e1e7c4fc56b53c6c73a655f65" alt="" width="1592" height="1062" data-path="images/integrate-your-issue-tracker/image-2.png" />
    </Frame>
  </Step>

  <Step>
    Click **Enable** next to Jira. The **Sync bug reports to Jira** modal appears.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-3.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=8fffe6a356875f3f9bd1f42de4d20bc5" alt="" width="826" height="240" data-path="images/integrate-your-issue-tracker/image-3.png" />
    </Frame>
  </Step>

  <Step>
    Click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-4.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=37b769f332605ee8945a9e87a2aea78a" alt="" width="1638" height="1040" data-path="images/integrate-your-issue-tracker/image-4.png" />
    </Frame>
  </Step>

  <Step>
    Select the Jira team you want to link to your QA Wolf team and click **Accept** to authorize the connection.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-5.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=adbaf2f315425cf035432cc3c414c8a5" alt="" width="1280" height="1772" data-path="images/integrate-your-issue-tracker/image-5.png" />
    </Frame>
  </Step>

  <Step>
    Choose your Jira **Project**, **Issue Type**, and **Assignee**, then enable:

    * **Create bug issue report**
    * **Close bug issue report**

    This ensures bugs are created and closed automatically across both systems.

    <Frame>
      <img src="https://mintcdn.com/qawolf/4XZ5s3xcaUDfoNRS/images/integrate-your-issue-tracker/image-6.png?fit=max&auto=format&n=4XZ5s3xcaUDfoNRS&q=85&s=7ea0e7bf5e06eaaa1c7d21185ab2ec3d" alt="" width="1320" height="2222" data-path="images/integrate-your-issue-tracker/image-6.png" />
    </Frame>

    <Tip>
      If there are any custom fields you need us to configure, such as the issue description, please reach out and let us know. We can configure those for you.
    </Tip>
  </Step>
</Steps>