# Jira configuration

## Sync the relevant projects

First, confirm that all the necessary Jira Projects have been synced to Swarmia. These can be edited at any time by an admin. Once a project has been fully synced, a green check mark will appear.

[Swarmia Jira settings](https://app.swarmia.com/settings/jira/general)

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

## Map issue types and statuses

Within an organization, there are likely many issue types and issue statuses associated with them. Swarmia has tooling to help normalize that data. You can map your issue types to the four types available in Swarmia: epics, stories, tasks, and bugs. A common example is grouping bugs, incidents, and other similar issues into the **Bugs** bucket.

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

Like issue types, the use of issue statuses often varies between teams. When you connect Jira to Swarmia, we automatically map the issue statuses across your projects to the four Swarmia issue statuses: to do, in progress, done, and won't do. Organization admins can adjust the mappings at any time.

<figure><img src="/files/6yXf3AaXhZJLiChwUt6S" alt=""><figcaption><p>Status mapping</p></figcaption></figure>

### Map issues to teams

When you create a new team, Swarmia automatically suggests a project to be mapped to the team. If you have a setup where multiple teams use the same issue tracker project, you can assign the right issues to Swarmia teams based on, e.g., labels or custom fields. Assigning issue ownership for teams is an essential step, as only then will the Jira issues and related data be visible in Swramia.

[Swarmia issues team settings](https://app.swarmia.com/settings/team/issues)

<figure><img src="/files/SIkRFi0DpYSqQG5hNfvU" alt=""><figcaption><p>A project-based issue ownership assignment</p></figcaption></figure>


---

# 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://help.swarmia.com/settings/integrations/issue-trackers/jira/jira-setup.md?ask=<question>
```

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.