# Jira

## Basics

Haystack utilizes Jira data to gather information about your past and active work. Historical data is used to generate metrics and reports, while active work is analyzed to inform you about the current state of your delivery.

## Configure

{% tabs %}
{% tab title="Update integration" %}
{% hint style="info" %}
Default token would give a sync time of 30 minutes.

To improve the sync time to 10 seconds check [Real Time Data Sync](https://help.usehaystack.io/setup/integrations/broken-reference) doc.
{% endhint %}

1. Go to [Org settings -> Integrations -> Jira](https://delivery.usehaystack.io/integrations/jira).
2. Click on menu icon and choose `Update`:

   <figure><img src="https://933147321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbiIqB8vq91hNrILQ1MAF%2Fuploads%2FtjdZoxb6XKwn7RxQr69l%2FExport-1716840663927.gif?alt=media&#x26;token=0125d986-ae6b-4897-b633-3bf45d0572cf" alt=""><figcaption></figcaption></figure>
3. Fill in requested fields:
   1. **API token:** go to [API Tokens page](https://id.atlassian.com/manage-profile/security/api-tokens) in Jira. Select from existing API tokens or create a new one. Make sure that token you create is not expired.
   2. **Email:** Use the email associated with your Jira account where the token was generated.
   3. **Jira Base URL:** You can find the Jira base URL in your browser's address bar

      <figure><img src="https://933147321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbiIqB8vq91hNrILQ1MAF%2Fuploads%2FopcLpNZHEyXJVwKGTHts%2Fimage.png?alt=media&#x26;token=386eec65-94f1-4036-9915-6eda7dbb7762" alt=""><figcaption><p><strong>Jira Base URL</strong></p></figcaption></figure>
4. Click `Connect`.
5. Wait for the data to sync. This usually takes about 1 hour, but can extend up to 6 hours depending on the organization size.
   {% endtab %}
   {% endtabs %}

## Permissions

List of data that is stored at Haystack:

<table><thead><tr><th width="175">Category</th><th>Data stored</th></tr></thead><tbody><tr><td>System</td><td>Issue statuses, priority types, column types, etc.</td></tr><tr><td>Issues</td><td>Title, content, create/update date, assignee, creator, reporter, custom fields (e.g., story points, sprints), etc.</td></tr><tr><td>Issue history</td><td>Title changes, assignee changes, etc.</td></tr><tr><td>Issue comments</td><td>Content, author info, etc.</td></tr><tr><td>Projects</td><td>Project name, type, key, issue types, etc.</td></tr><tr><td>Sprints</td><td>Start/end dates, title, state, etc.</td></tr><tr><td>Boards</td><td>Board JQL, title, column metadata, etc.</td></tr><tr><td>Members</td><td>Name, account ID, email, etc.</td></tr></tbody></table>

## FAQ

<details>

<summary>Why is my Jira Project or Board is missing?</summary>

This is likely due to limited access in your JIRA integration. To fix this, update your JIRA Integration token by following the steps below!

* Access Integration Settings
  * Visit: [Haystack JIRA Integration Page](https://dash.usehaystack.io/hub/integrations/jira)
  * Click the three dots next to JIRA integration and select "Update" .

    <figure><img src="https://downloads.intercomcdn.com/i/o/908473666/20aae0bc20f0d5f6a49a644d/Screenshot+2023-12-13+at+7.56.25%E2%80%AFPM.png" alt=""><figcaption></figcaption></figure>
* Update Integration Token
  * Generate a new token in JIRA with access to the specific board or project
* Update Integration in Haystack

  * Paste the new token in Haystack's JIRA settings.

  <figure><img src="https://downloads.intercomcdn.com/i/o/949148934/26cb97424840c35f660c4d72/Screenshot+2023-12-13+at+7.54.57%E2%80%AFPM.png" alt=""><figcaption></figcaption></figure>
* Verify Access
  * Check if you can now see the board or project.

</details>