Skip to content

Jira integration#

The Jira integration incorporates Codacy on your existing Jira workflows.

When the integration is enabled, you can create issues on a Jira project directly from Codacy when browsing the existing issues on the repository:

Jira integration for issues

Enabling the Jira integration#

To enable the Jira integration:

  1. Open your project Settings, tab Integrations.

  2. Click the button Add integration and select Jira on the list.

  3. Configure the Jira integration fields as follows:

    Enabling the Jira integration

    • Host URL: Base URL of your Jira instance, including the protocol. For example, https://mycompany.atlassian.net/.
    • Project ID: Key of the Jira project where Codacy will create issues. You can obtain the project key from the prefix of Jira issue numbers in that project. For example, DOCS for a project with the issue DOCS-42.
    • Email: Email address of the user account that Codacy will use to create new issues in Jira.
    • API token: Jira API token for the user account that Codacy will use to create new issues in Jira. The Jira integration only supports HTTP basic authentication.

    Important

    We recommend that you use a dedicated service account for integrating Codacy with Jira. Jira issues created by Codacy will appear as being reported by this user account.

  4. Click Save and make sure that Codacy can successfully establish a connection with Jira.

  5. Click Advanced to configure the issue type and any built-in or custom Jira fields of new issues created by Codacy.

    Advanced settings of the Jira integration

Was this page helpful?

Your feedback helps us improve the documentation.

Edit this page on GitHub Contact support