# Jira
## Jira + Multitudes Integration Benefits
* Get visibility over velocity and spread of work with [`Types of Work`](/metrics-and-definitions/process-metrics/value-delivery/types-of-work.md) insights
* See the balance between [`Feature and Maintenance work` ](/metrics-and-definitions/process-metrics/value-delivery/feature-vs-maintenance-work.md)
## How it works
Issue data from Jira will be sent to Multitudes. This data is then processed by our data pipelines and shown in the Multitudes app as actionable insights around [`Value Delivery`](/metrics-and-definitions/process-metrics/value-delivery.md).
We pull up to 200 Jira projects, ordered by the latest issue updated. We check for new projects and update this list daily. We pull up to 200 epics and 200 labels. The Jira API does not provide us a way to sort these or filter by any sort of date field, so they are just the first 200 returned by their API.
Your Jira insights can be categorised based on Issue Type, Epic, and/or Label (see [Customize Work Categories](https://docs.multitudes.com/configuration-and-setup/customize-work-categories#how-to-customize-work-completed)).
## Requirements
In order to install this integration, you must have both:
* Owner or Manager level [permissions](/configuration-and-setup/permissions-and-roles.md) on Multitudes, and
* Jira System Administrator role to set up the connection to your organization’s Jira account
## How to install
On the Multitudes app, go to the [Integrations page](https://app.multitudes.co/teamSettings/integrations) (from the menu, find Account, click Settings, then click the Integrations tab across the top). Find the card that says Jira in the top Integrations section and click ‘Connect’ at top right.
1. After you click 'Connect' on the Jira card on the Integrations page, on the resulting pop-up click ‘Connect Jira projects’
2. This opens a new page on Atlassian Marketplace, click ‘Try it free’
3. This pops up a modal. In this modal, first, select your site; second, click the button to ‘Start free trial’. Don’t worry this integration is not separately charged beyond your instance of Multitudes!
4. This pops up a new modal, click ‘Get started’
5. This will close the modals, on the resulting page, a dialog box should pop up on the lower left hand corner indicating that the install is in progress. Once complete, it will show success, from this dialog box, click ‘Get started’
6. A new tab will open, on this tab, click ‘Allow access’
7. A new tab will open, scroll to the bottom and click ‘Accept’
8. This will close the last tab. On the resulting page, click the button ‘Connect with Multitudes’
9. You'll be redirected back to our app where you’ll see a pop-up asking you to link Jira users with Multitudes users. This will determine whose Jira data we know to show in Multitudes, so it's important to complete this step. [Learn more about user linking](/configuration-and-setup/user-linking.md).
{% hint style="info" %}
When populating the user linking list, we include the names of any users who appear as the Creator, Assignee, or Reporter for any issue in our database.
{% endhint %}
10. Lastly, you’ll see a success message in the pop-up!
{% hint style="warning" %}
Once the installation is finished and teams are linked, you will need to **wait a few minutes, then refresh the app** to see the charts. Until the charts are ready, you will see the message "No data for this time period" on the Value Delivery page (screenshot below).
{% endhint %}
## How to Uninstall
Follow the link below – you’ll need to input your Atlassian org:
```
https://[YOUR_ATLASSIAN_ORG].atlassian.net/plugins/servlet/upm
```
Then find the listing for Multitudes for Jira and click “uninstall”.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.multitudes.com/integrations/jira.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
