Pushing issues to Jira

With SonarQube Cloud integration with Jira Cloud, you can use Jira work items to manage your SonarQube Cloud issues.

The Jira Cloud integration is available in the Team and Enterprise plans. For more information about this integration, see Jira Cloud.

Once your project admin has connected your SonarQube project to a Jira Cloud space, you can view the Jira Cloud release widget on the Summary page of your main branch in SonarQube Cloud, and you can push SonarQube issues to Jira.

• You cannot push a SonarQube issue to an existing Jira work item, which means you can only create new Jira work items from SonarQube issues.

• You cannot push the same issue to multiple Jira work items. But, on rare occasions, two or more concurrent Jira creation events might be triggered by multiple users simultaneously, resulting in two or more Jira work items being connected to the same issue.

Creating a Jira work item from a single SonarQube issue

You can create a Jira work item from a SonarQube issue or from the Issues page:

1. Click the Push to Jira button and choose a Jira work type, if more than two work types are available. The list of Jira work types depends on your Jira Cloud integration configuration and is configured by the project administrator.

1. When the process is complete the button displays a Jira work item ID along with the status label.

2. A new Jira work item will be created in your Jira Cloud space and it will open in a new tab.

3. Click on the Jira work item ID to open it on the Jira’s website. You can also navigate from the Jira work item back to the SonarQube issue.

On rare occasions, two or more concurrent Jira creation events might be triggered by multiple users simultaneously, resulting in two or more Jira work items being created at the same time.

Creating a Jira work item from multiple SonarQube issues

You can push multiple SonarQube issues into a single Jira work item from the project’s issues page in SonarQube. A maximum of 500 SonarQube issues can be included in a Jira work item.

SonarQube creates a Jira work item with issues that have not been previously connected to Jira. If you have selected issues that currently have a Jira connection and you want to include them in this Jira work item, you will have to disconnect them from Jira first. See Disconnecting a Jira work item for more information.

To create a Jira work item from multiple SonarQube issues:

1. In the Issues page, select the issues you want to include in the Jira work item.

2. Click Push to Jira at the top of the issues page to open a modal.

1. In the modal, select the work type that you want to apply to the Jira work item.

Disconnecting a Jira work item

You cannot delete a Jira work item from within SonarQube Cloud, but you can disconnect it by clicking on the close icon of the Jira button either within the SonarQube issue or on the Issues page. The connection with the Jira work item will be removed but the item will still exist in Jira Cloud.

Navigating to the open Jira issues

You can navigate from an issue in SonarQube Cloud directly to its corresponding Jira work item. In addition, the Jira widget that appears on the Summary page for the main branch allows you to view the number of open issues in the earliest unreleased version of your project. Click this number to navigate to them in Jira Cloud.

Related pages

• Jira Cloud (integration overview)

• Connecting your organization to Jira Cloud

• Connecting your project to Jira Cloud