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:

1. Log in to an Atlassian account that has write access to Jira projects.
2. 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.

3. Click Create API token.

   The system displays the Create an API token dialog box.

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

Connecting to Code Studio¶

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

4. In the left navigation page, click Integrations.

   The system displays the Integrations page.

5. In the Add an integration section, click Jira.
6. In the Connection details section, do the following:
   1. 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.

   2. 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.

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

   1. 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.

   2. 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.

   3. To configure automatic issue transitions in Code Studio, select the Enable Jira transitions checkbox.
8. (Optional) In the Jira issue matching section, do the following if you need to configure custom rules for Jira issue key matching:
   1. In Jira issue regex, enter a regex pattern.
   2. In Jira issue prefix, enter a prefix.
9. (Optional) To test the Jira integration settings, click Test settings.
10. Click Save changes.
11. In the left navigation page, click Plan > Issues.
12. 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.