Prerequisites

The following are the prerequisites for setting up the Jira integration:

• A user account on Jira Cloud
• A Jira Cloud API token

Creating a Jira Cloud API token

To create a token:

• Log in to an Atlassian account that has write access to Jira projects.
• Use one of the following steps to access the API Tokens page:
  • Go to https://id.atlassian.com/manage-profile/security/api-tokens.
  • Click your profile icon and then click Manage account > Security > Create and manage API tokens.

• Click Create API token.

  The system displays the Create an API token dialog box.

• In Label, enter a label for your token and click Create.
• Click Copy to copy the token.

Connecting to Code Studio

• Log in to Code Studio.
• On the left sidebar, click Search or go to and find your project.
• On your project page, click Settings.

• In the left navigation page, click Integrations.

  The system displays the Integrations page.

• In the Add an integration section, click Jira.
• In the Connection details section, do the following:
  • In Web URL, enter the base URL for the Jira instance web interface that you want to link to this Code Studio project. For example, https://jira.example.com.

  • In Jira API URL, enter the base URL for the Jira instance API. For example, https://jira-api.example.com.

    If you do not set the URL, the default value is Web URL. For Jira Cloud, leave this field blank.

  • In Authentication method, select Basic.
  • In Email or username, enter your Jira Cloud email address.
  • In API token or password, enter the API token for Jira Cloud that you copied in Creating a Jira Cloud API token.
• In the Trigger section, do the following:

  • Select the Commit, Merge request, or both checkboxes.

    When you specify a Jira issue ID in a commit or merge request, Code Studio links to the issue.

  • To enable commenting in the Jira issue that links back to Code Studio, select the Enable comments checkbox.

    The system displays the Comment detail sub-section with Standard and All details options. You can choose one of the options based on what details you want the comment to display.

  • To configure automatic issue transitions in Code Studio, select the Enable Jira transitions checkbox.
• (Optional) In the Jira issue matching section, do the following if you need to configure custom rules for Jira issue key matching:
  • In Jira issue regex, enter a regex pattern.
  • In Jira issue prefix, enter a prefix.
• (Optional) To test the Jira integration settings, click Test settings.
• Click Save changes.
• In the left navigation page, click Plan > Issues.
• Click Import issues and select Import from Jira.

Your Code Studio project can now interact with all Jira projects in your instance. The project displays a Jira link that opens the Jira project.

Setting up the Jira integration