Connecting your project to Jira Cloud
How to connect your SonarQube Cloud project to a Jira Cloud space to allow users to push issues to Jira Cloud.
The Jira Cloud integration is available in the Team and Enterprise plans. For more information about this integration, see Jira Cloud.
Once your SonarQube organization has been connected to your Jira Cloud instance, you are now ready to connect your SonarQube project to a Jira space. You only need to be a project admin provided your organization admin has allowed project admins to connect their projects to Jira. Otherwise, you must be an organization admin.
Prepare the Jira Cloud space to be connected
You must select the Jira Cloud space you want to connect your SonarQube Cloud project to.
Be aware that SonarQube Cloud supports only the following Jira’s mandatory fields:
Summary
Description
Reporter
Jira work types that have other mandatory fields associated with them, and have no default value, are not supported and are disabled in SonarQube Cloud. You can either remove these mandatory fields in Jira or choose a supported work type in SonarQube. At least one supported Jira work type is required to save the configuration.
The SonarQube Cloud’s Jira widget will show the open Jira work items in the earliest unreleased version of your project regardless of whether they are associated with SonarQube issues or not (see Jira widget for more information). It means that:
You must use the release concept with your Jira Cloud space to benefit from the widget.
If your project contains work items that are not connected to SonarQube issues, they may be shown by the widget.
Connect your SonarQube project to your Jira space
To connect your SonarQube Cloud project to your Jira Cloud space:
Go to Your Project > Administration > General Settings > Jira.
Click Connect to open the connection modal.
In the modal, select a Jira space from a dropdown list. A maximum of 1,000 items is available. Use the search option to quickly find a specific project.
Choose the work types that you can push from SonarQube to Jira Cloud (you can change them later if necessary).
Click Connect. A confirmation dialog opens.
Confirm. Once the connection is created you will see the connection details along with options to edit or delete the project binding.
Test the connection
Go to the Main Branch Summary page of your SonarQube Cloud project and verify that the widget is shown. If the widget shows a warning indicating that it cannot show the issues, it means that your Jira Cloud space doesn’t use the release concept. See Prepare the Jira Cloud space to be connected.
Navigate to an issue in your SonarQube Cloud project and push it to Jira: see Pushing issues to Jira. If the Push to Jira button is not displayed, it might mean that none of the Jira work types configured in the project connection is supported by SonarQube Cloud. See Prepare the Jira Cloud space to be connected.
Editing your project connection
You can change the connection of your SonarQube project by connecting it to another Jira space or by updating the list of Jira work types configured for the connection.
Changing your project connection is non destructive, meaning that all the connections of the project’s issues with Jira work items will remain intact.
Proceed as follows:
If you want to connect to another project, follow the instructions in Prepare the Jira Cloud space to be connected above.
Go to Your Project > Administration > General Settings > Jira.
Select Edit. The connection modal opens.
You can select another project and / or select other work types.
Select Connect.
Deleting your project connection
Deleting the project connection is a complete reset between your SonarQube project and Jira. It means that the Jira widget will be removed from your project and the connections to the created Jira work items will be lost.
Proceed as follows:
Go to Your Project > Administration > General Settings > Jira.
Select the delete icon.
Related pages
Jira Cloud (integration overview)
Last updated
Was this helpful?