> For the complete documentation index, see [llms.txt](https://docs.testery.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testery.io/integrations/built-in-integrations-with-testery/jira.md).

# Jira

##

{% embed url="<https://vimeo.com/930020667/a8ff136225?share=copy>" %}

## Setup

1. Navigate to the Integrations tab in Settings and click the "Authorize Jira Integration" button.\ <img src="/files/d62sctXDIyBG0LB1bZx9" alt="" data-size="original">
2. Review the requested permissions and click the "Accept" button when ready. You will be redirected back to the Testery app and your Jira Integration setup is complete.\
   ![](/files/RCBgB8pmDkjSiGhwQtSA)

## How to Create a Jira Story

There are 3 ways to do this...

### From Test Results

1. When viewing a test result, choose any "Review Status".\
   ![](/files/DyyRXJc1NO8b1P2Dxnu0)![](/files/0ixirN0HiVlyf9PdkHZ9)
2. You will be prompted to create a Jira Issue, click "Yes".\
   ![](/files/fnMFaU1cGBtCGIm5xXvK)

### From a Test Run Analysis

* Under the Analysis tab when viewing a test run, click the "Create Jira Issue" button.\
  ![](/files/BOAW9G17n4DHv3TuQQtm)
* On a Test Run Analysis Slack message, click the "Create Jira Issue" button.\
  ![](/files/5fUjdde5VENTaXtDgITm)