## What is included in the Jira integration?

URL: https://docs.atlan.com/product/integrations/project-management/jira/faq/jira-integration

> With two of your most important workspaces connected, you can save time and improve the way you track issues for your data.

With two of your most important workspaces connected, you can save time and improve the way you track issues for your data.

Once you integrate Jira with Atlan you can do all of the following - all without leaving Atlan!

- Create new Jira issues on assets
- Link existing Jira issues to assets
- See the complete history of Jira issues for each asset

:::info **Did you know?** 
 To use all of the features outlined, each user needs to [connect their individual Jira account](https://docs.atlan.com/llms/governance/integrations/link-your-jira-account/llms.txt) to their Atlan profile.

:::

## Create new Jira issues on assets

:::warning

You will first need to [add a labels field](https://support.atlassian.com/jira-service-management-cloud/docs/add-fields-to-a-screen/) to your _Create issue_ form in Jira to be able to create Jira issues on your assets in Atlan.

:::

To create issues in Jira, without leaving Atlan:

1. From any asset, on the right of the screen, click the **Jira** sidebar icon.
2. Click the **Add Issue** button, and then **Create Issue**.
3. From the _Creating issue_ dialog:
 1. (Optional) For _Project_ select the project for the issue. (By default, the project [configured during integration](https://docs.atlan.com/llms/governance/integrations/integrate-jira-cloud/llms.txt) will be selected.)
 2. (Optional) For _Issue type_ select the type of issue being created in Jira.
 3. For _Title_ enter a brief summary of the issue.
 4. For _Description_ enter the detailed explanation of the issue.
4. Click the **Create** button to submit your issue to Jira.

Your issue is now on Jira and linked to the asset for future reference! 🎉

## Link existing Jira issues to assets

Ever determine that an issue in Jira is related to multiple data assets? It's important to bring that context back to your assets.

To add existing issues in Jira into Atlan:

1. From the asset, on the right of the screen, click the **Jira** sidebar icon.
2. Click the **Add Issue** button, and then **Link Issue**.
3. From the _Link Issues_ dialog:
 1. (Optional) Search for any issues in Jira to link.
 2. Check each issue that should be added to the asset.
 3. At the top of the dialog, click the **Link** button.

Your existing issue on Jira is now linked to the asset for future reference! 🎉

---