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

# Jira Data Ingestion

> Import Jira issues as knowledge sources for your Guru

Turn your Jira history into AI knowledge. Import resolved issues, bug reports, and feature discussions so your Guru can answer questions based on real engineering context and decisions.

## Why Ingest Jira Data?

<CardGroup cols={2}>
  <Card title="Engineering Context" icon="code">
    Past issues contain decisions, workarounds, and solutions that help answer new questions
  </Card>

  <Card title="JQL-Powered Selection" icon="filter">
    Use Jira Query Language to import exactly the issues you need
  </Card>

  <Card title="Attachments Included" icon="paperclip">
    Images, logs, and text files attached to issues are indexed too
  </Card>

  <Card title="Auto-Sync" icon="rotate">
    Backfill jobs automatically import new resolved issues on a schedule
  </Card>
</CardGroup>

## What Gets Indexed

| Content Type    | What's Included                          |
| --------------- | ---------------------------------------- |
| **Issues**      | Issue title, description, and all fields |
| **Comments**    | Full comment threads with context        |
| **Attachments** | Images, logs, and text files             |
| **Metadata**    | Status, priority, labels, and resolution |

<Note>
  **Self-Hosted (Enterprise):** This integration is in beta for selected users.
  **Cloud:** Available to all users.
</Note>

***

## Setup

<Steps>
  <Step title="Create Atlassian API Token">
    1. Go to [Atlassian API Token settings](https://id.atlassian.com/manage-profile/security/api-tokens)
    2. Click **Create API token**
    3. Copy the token
  </Step>

  <Step title="Navigate to Jira Integration">
    Go to **Gurubase Dashboard** → Select your Guru → **Integrations** → **Ingestions** → **Jira**
  </Step>

  <Step title="Connect Your Jira">
    Fill in the connection details:

    | Field          | Value                                                     |
    | -------------- | --------------------------------------------------------- |
    | **Domain**     | Your Atlassian domain (e.g., `yourcompany.atlassian.net`) |
    | **User Email** | Your Atlassian account email                              |
    | **API Token**  | The token you created in Step 1                           |

    <Frame>
      <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/jira/jira-fields.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=7e3106d8e67c09502fae254f419d2495" alt="Jira Integration Fields" width="1860" height="1332" data-path="images/ingestion/jira/jira-fields.png" />
    </Frame>
  </Step>
</Steps>

***

## Adding Jira Content

After connecting, you can import issues in two ways:

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/jira/modal.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=f15bcc7302a02d601017da946e112df1" alt="Add Jira Content Modal" width="3020" height="1616" data-path="images/ingestion/jira/modal.png" />
</Frame>

### Option 1: Add Individual Issues

Best for importing specific issues by URL.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/jira/individual.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=ed9b365908a84fcb177583ec60b8e111" alt="Add Individual Jira Issues" width="3010" height="1616" data-path="images/ingestion/jira/individual.png" />
</Frame>

| Setting        | Description                                       |
| -------------- | ------------------------------------------------- |
| **URLs**       | Enter issue URLs, one per line                    |
| **Date Range** | Optionally filter by creation date                |
| **JQL Filter** | Additional JQL criteria (e.g., `status = "Done"`) |

### Option 2: Create Backfill Job

Best for bulk imports and automatic ongoing sync using JQL queries.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/jira/backfill.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=d0ea4baad5a22ae0d56cdbdf02b47bc6" alt="Create Jira Backfill Job" width="3016" height="1608" data-path="images/ingestion/jira/backfill.png" />
</Frame>

| Setting           | Description                                        |
| ----------------- | -------------------------------------------------- |
| **JQL Query**     | Query to select which issues to import             |
| **Sync Interval** | How often to check for new issues (minimum 1 hour) |
| **Sync Now**      | Manually trigger an immediate sync                 |

### Example JQL Queries

```sql theme={null}
-- All resolved issues from a project
project = "SUPPORT" AND status = "Done"

-- Recent high-priority bugs
project = "ENG" AND type = "Bug" AND priority = "High" AND created >= -30d

-- Issues with specific labels
labels IN ("documentation", "faq") AND resolution IS NOT EMPTY
```

<Tip>
  Import resolved issues to build knowledge from solutions. Use backfill jobs to automatically keep your Guru updated as new issues are resolved.
</Tip>

***

## Viewing Indexed Content

Imported issues appear as individual sources in your Guru's data sources list. You can:

* View the exact content that was indexed
* Remove specific issues
* Check when content was last synced

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Jira Bot" icon="jira" href="/integrations/bots/jira">
    Deploy Gurubase as a Jira bot for ticket responses
  </Card>

  <Card title="Confluence Ingestion" icon="confluence" href="/integrations/ingestion/confluence">
    Import Confluence pages
  </Card>

  <Card title="Zendesk Ingestion" icon="headset" href="/integrations/ingestion/zendesk">
    Import Zendesk tickets and articles
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Add more knowledge sources
  </Card>
</CardGroup>