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

# Jira

> Create and link Jira issues from alerts and incidents.

| Property  | Value                                    |
| --------- | ---------------------------------------- |
| **Type**  | Contextual                               |
| **Level** | Service                                  |
| **Auth**  | Atlassian OAuth (shared with Confluence) |

Warrn connects to Jira so you can create and link issues directly from alerts and incidents. Warrnagen can also search Jira for related issues during investigations.

## Setup

<Steps>
  <Step title="Connect Atlassian">
    In Warrn, go to **Settings > Integrations**. Find Atlassian and click **Connect**. Authenticate with your Atlassian account. This grants access to both Jira and Confluence.
  </Step>

  <Step title="Add to a service">
    Open a service or team in Warrn. Go to the **Integrations** tab, add **Jira**, and select which Jira project to use.
  </Step>
</Steps>

<Note>
  Use a [bot account](/integrations/bot-account) for the Atlassian OAuth connection so it doesn't break if someone leaves.
</Note>

## Capabilities

* **Create issues.** Create a Jira ticket from an alert or incident.
* **Search issues.** Find related Jira issues during triage.
* **Link issues.** Associate existing Jira tickets with alerts.
* **List projects.** Browse available Jira projects.