> ## Documentation Index
> Fetch the complete documentation index at: https://qawolf-goran-unruffled-wing-322a2c.mintlify.site/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.

<Note>
  **Full Service Customers:** Need help setting up your JIRA integration? The QA Wolf team can configure this integration on your behalf. To get started, invite us as a user in your JIRA workspace using the following email convention: qa+\[yourcompanyname]@qawolf.com (e.g. [qa+acme@qawolf.com](mailto:qa+acme@qawolf.com)).
</Note>

## Set up the integration

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

    <Frame>
      <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-1.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=f9836428db441b5952605fb5c90272eb" 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-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-2.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=bb9a97c900b1e3c9f85f2ca3b415ecee" 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-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-3.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=b7b9438304f611278e0ae660834ba8dd" 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-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-4.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=775f026d669b6b1b01777cffec50e73d" 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-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-5.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=4b193a353a6acbed0e0c44996b98f73e" 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-goran-unruffled-wing-322a2c/gBVgnma15fs5V8an/images/integrate-your-issue-tracker/image-6.png?fit=max&auto=format&n=gBVgnma15fs5V8an&q=85&s=e12f08ac0bb67272626f14f518e4d899" 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>