> ## Documentation Index
> Fetch the complete documentation index at: https://qawolf-flows-tab-consolidation-outlining.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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-1.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=6f6d3bb94d8b1aa832dd5f2a2f0f62d4" 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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-2.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=eb0a578d6be5fd8b3c34148951663b53" 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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-3.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=1e9aa27cc5c04baf03ee2d5039f5ccc5" 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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-4.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=fbdfc259126a045ddd3df5c8ca8f5151" 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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-5.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=00696eb94a802df5b223fdb2d42f74f6" 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-flows-tab-consolidation-outlining/Vr8yEXyPb0rB62tz/images/integrate-your-issue-tracker/image-6.png?fit=max&auto=format&n=Vr8yEXyPb0rB62tz&q=85&s=7566cffe823c08b35d982408cb73f051" 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>