> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/settings/jira-integration/adding-projects-to-a-jira-integration.md).
# Adding Projects to a Jira Integration
{% hint style="warning" %}
#### Written for the Old UI
This article was written for the old UI. The instructions are still usable, but the screenshots are outdated. In some cases, items referenced in the instructions have moved or changed. If you cannot find an item, see the [Where Did It Go](/devops/new-ui-ux-transition/where-did-it-go.md) article.
{% endhint %}
##  Overview
This article shows you how to add your Jira projects to a connected Jira integration. Once a project is added, you can configure the organization's status mapping and add project stories to a branch.
## Adding a Project
{% stepper %}
{% step %}
### Select Jira Integration
1. Click **Settings** from the left sidebar menu.
2. Click the **Integrations** tab.
3. Click **User stories integrations**.
4. Click the Jira integration to add a project to.
{% endstep %}
{% step %}
### Add Projects
1. Click **Add Project**.
2. Click the **Projects** dropdown menu.
3. Select each of your Jira projects to add to this integration.
{% hint style="info" %}
Click a Jira project in the dropdown menu to select it, and a check mark will appear to the right. You can select multiple projects at once. To unselect a project, click it again to remove the check mark. If you have many projects, use the search bar to find them quickly.
{% endhint %}
4. Once you have selected the projects, click outside of the menu to close it.
5. Click **Add projects**.
6. Each project you added will be listed in the Jira Integration.
{% endstep %}
{% step %}
### Configure Projects
After adding a project, configure it to define your organization's status mapping. This tells the Jira integration which status to apply to a related Jira story when you deploy a branch to an organization. For instructions on configuring a project, see the following article.
* [Configuring a Jira Project](/devops/settings/jira-integration/configuring-a-jira-project.md)
{% endstep %}
{% endstepper %}
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/settings/jira-integration/adding-projects-to-a-jira-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
