# Atlassian Jira

> Integrate your Atlassian Jira instance to Test Manager to add defect reports, and assign stories and requirements to your tests. The integration works with all Jira project types.

Integrate your Atlassian Jira instance to Test Manager to add defect reports, and assign stories and requirements to your tests. The integration works with all Jira project types.

To integrate Jira to Test Manager, follow these procedures:

Step 1: [Install UiPath® Test Manager for Jira](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/connecting-a-jira-project#install-uipath%C2%AE-test-manager-for-jira)

Step 2: [Configure a a Jira connection](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/connecting-a-jira-project#configure-jira-connection)

Step 3: [Configure Jira project](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/connecting-a-jira-project#configure-jira-project)

## Supported object types and data transfer direction

## Supported objects

* Items synchronized from Jira to Test Manager are read-only except for attachments, object labels and test case links.
* [Defects](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/defect-synchronization#defect-synchronization) are synchronized from test executions in Test Manager to Jira.

## Data transfer

The direction of data transfer and corresponding objects are listed in the following table:

| Xray for Jira | Direction | UiPath Test Manager |
| --- | --- | --- |
| Requirements | → | Requirements |
| Defect | ← | Defects |

## Install UiPath® Test Manager for Jira

1. Open your Jira instance in your browser.
2. Log in as an administrator.
3. Click **Manage Apps** from the administration menu.
4. Under **Find new Apps** search for UiPath®.
5. Select **UiPath® Test Manager for Jira**.
6. Click **Install**.

   The latest version of UiPath® Test Manager for Jira is installed.

## Configure Jira Connection

All the objects that you create in Test Manager will have the identity of the Jira user used for this connection. The connection is established based on the type of Jira product that you are using. For Jira Data Center, you need to set a connection for **Jira Server**. For Jira Cloud, you need to configure a connection for **Jira Cloud**:

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** &gt; **Integration**.
4. Click **New Connection** and select either **Jira Server**(Jira Data Center), or **Jira Cloud**.

   The default authentication type used is **Basic Authentication**. You can't change the authentication type.
5. Configure the following connection settings:
   * **Name**: Enter a name for your Jira connection.
   * **Description** (Optional): Add a description for reference.
   * **Server URL**: Add the Jira server URL. This is the URL of the server that exposes the Jira REST API. It is usually identical to the URL you navigate to when using Jira through your browser. For example: `https://company-name.atlassian.net`.
   * **Web URL** (Optional: Enter the URL of the Jira REST API in case the Jira REST API is not hosted under the same URL as the web UI.
   * **User**: The username you use to authenticate to the Jira API.
   * **Password** (Jira Server only): The password you use to authenticate to the Jira API.
   * **API Token** (Jira Cloud only): [Generate an API token](https://id.atlassian.com/manage-profile/security/api-tokens). For more information on Atlassian API tokens, see [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).
   * **Defect Type**: Specify the Jira object-type to be used for defects. Usually, that will be a bug. To disable defect integration for this connection, select **None**.
   * **Project Key**: Enter the project key from Jira which refers to the project you want to integrate.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126859-d77939a1-5e801b73.webp)
6. Click **Save**.
7. Click the connection to expand the panel and copy the **API Key** for later use.

## Configure Jira Project

1. Open Jira and navigate to the project you want to integrate with Test Manager.
2. Switch to the project settings.
3. Scroll down and select **UiPath® Test Manager** to open the Test Manager configuration page.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125942-b0899a5e-31434a1a.webp)
4. Select all Jira issue types that you want to be synchronized as requirements to Test Manager.
5. Enter the **Server URL** from Test Manager (e.g., `https://{yourDomain}`).
6. Paste the **API Key** you copied at step 7 from the previous procedure.
7. Click **Save**.

## Working With Jira Integration

To understand how integration works with the help of [Xray for Jira](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/connecting-an-xray-project#xray-for-jira) and, take a look at the following video:

## Managing Jira connections

The following table lists the actions that you can take to manage your Jira connections.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Action  
     Description  
     Procedure  
  
 
 
  
    Edit 
     Edit your connection settings.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Navigate to Project Settings &gt; Integration . 
         Click a Jira connection to expand the panel. 
         Click Edit to configure the connection. 
         Click Save to confirm changes. 
      

  
  
    Delete 
     Delete the selected connection and its associated requirements.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Navigate to Project Settings &gt; Integration . 
         Click a Jira connection to expand the panel. 
         Click Delete to remove the connection. 
         Click Ok to confirm changes. 
      

  
 

Related articles

[Defect synchronization](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/defect-synchronization#defect-synchronization)
