> 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

Testery's built-in Jira integration allows user to create stories for errant tests and bugs found while testing. Stories can be tied to individual or groups of tests.

##

{% 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="https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-956798e7a77f9a1289c7f0c748f828ac8e242ce9%2Fimage.png?alt=media" 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.\
   ![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-d1a3c120da00423e6209199d692bf519fcf84574%2Fimage.png?alt=media)

## 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".\
   ![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-0fa346fcbd08fd777137fbb7a4e2e872a1748a50%2Fimage.png?alt=media)![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-559ac5f0ecb6cbee8ff92d80d27bc0095d5beab0%2Fimage.png?alt=media)
2. You will be prompted to create a Jira Issue, click "Yes".\
   ![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-9706e850d288577837dbf4b8b437a5bca9a632a3%2Fimage.png?alt=media)

### From a Test Run Analysis

* Under the Analysis tab when viewing a test run, click the "Create Jira Issue" button.\
  ![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-1f4cbff03027806cc8ebe6724340f692051192f2%2Fimage.png?alt=media)
* On a Test Run Analysis Slack message, click the "Create Jira Issue" button.\
  ![](https://4041872331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MK0kYmwONk3GqQ8OhVA%2Fuploads%2Fgit-blob-f5d2923655c6fba6f7509539d3a4ff6afaf70c26%2Fimage.png?alt=media)