---
title: "Setting up the Jira integration"
date: "2024-12-30T16:33:40+00:00"
summary: "Connect Code Studio to Jira Cloud: Set up integration, link issues, and enable automatic transitions for seamless project management."
image:
type: "page"
url: "/acquia-cloud-platform/add-ons/code-studio/setting-jira-integration"
id: "3815a8e6-82cf-48cf-9dec-81e3c3e4f8f0"
---

Table of contents will be added

### 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](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](#section-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.