> For the complete documentation index, see [llms.txt](https://help.swarmia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.swarmia.com/settings/integrations/issue-trackers/jira.md).

# Jira

Swarmia supports Jira Cloud, Jira Server, and Jira Data Center. You can connect Jira independently of your code hosting integrations.

Choose the installation method that matches your Jira setup:

* **Jira Cloud:** follow the steps below to install Swarmia from the Atlassian Marketplace
* **Jira Cloud with limited project access:** use [API token setup](/settings/integrations/issue-trackers/jira/limiting-jira-project-access.md)
* **Jira Server or Jira Data Center:** use [on-premise setup](/settings/integrations/issue-trackers/jira/jira-server-and-jira-data-center.md)

## Jira Cloud

* Start by ensuring you have Jira admin permissions
* Navigate to [Jira settings in Swarmia](https://app.swarmia.com/settings/jira) and follow the installation guide
* Once installed, click the **Configure** link in the pop-up

<figure><img src="/files/JG388YTXxl1wOxDmAvnF" alt=""><figcaption></figcaption></figure>

In app's configuration, you need to click **Finish installation**, after this, the page should show "Swarmia is connected to your Jira site".

{% hint style="danger" %}
**Note:** Some browser security features might block you from finishing the installation. If you are logged in but still see a warning to log in, please check that ad-blockers or tracking protection systems (eg. on Firefox or Safari) are not blocking a request to swarmia.com.
{% endhint %}

You can also access the configuration page by navigating to **Jira settings > Apps > Manage apps.**

{% hint style="success" %}
Once the Jira integration is installed, proceed to [Jira configuration](/settings/integrations/issue-trackers/jira/jira-setup.md).
{% endhint %}

### Updating Jira URL

Let us know at **<hello@swarmia.com>** if you update your Atlassian (Jira) URL. We’ll need to update it on our end and re-sync your Jira integration. This ensures continuous data flow and prevents issues caused by outdated URL references.

There may be a brief delay before the updated Jira data appears in Swarmia. To minimize this, we recommend notifying us in advance so we can coordinate the update with you.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.swarmia.com/settings/integrations/issue-trackers/jira.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.