> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/administration/integrations.md).

# Integrations

## Jira Integration Overview

Integrating **TestFirst** with **Jira** enables seamless collaboration between QA and development teams.\
Once connected, you can create, link, and view issues across both systems to streamline bug tracking and test management.

***

#### What You Can Do

With the Jira integration, you can:

* **Create bug reports** in Jira directly from TestFirst.
* **Link test cases** in TestFirst to Jira issues.
* **View linked test cases** inside Jira issues for full visibility.

***

### Setup Requirements

To enable the integration, complete the following steps:

1. **Create a TestFirst user**—we recommend using a **Service User** (sign up [here](https://www.testfirst.com/plans)).
2. **Install and configure** the TestFirst app in Jira - this should be done by your **Jira Administrator**.
3. **Configure Jira integration** in TestFirst - must be performed by a user with the required permissions.
4. **Authenticate in TestFirst** using your Jira credentials - each user must do this individually.

***

## Install and Configure TestFirst App in Jira

To enable viewing **TestFirst test cases inside Jira issues**, you must install and configure the **TestFirst app** in your Jira instance.\
These steps only need to be completed **once** by a **Jira Administrator**.

***

### Steps to Install the TestFirst App

1. Open the [**TestFirst app installation page**](https://developer.atlassian.com/console/install/49abde0f-591f-457b-b369-49056705c065/?signature=d630569e60d8353ab7e15e7574685e520dacc84f52b6c7bcb75133b0bd44cbc3\&product=jira) in your browser.
2. Click **Get app**. An *Install ‘TestFirst‘ by FirstCall QA* dialog will appear.
3. Select the **Jira site** where you want to install the app.
4. Click **Install**. The app will be installed on the selected Jira instance.

***

### Steps to Configure the App

1. In your Jira instance, click **Settings** → **Marketplace Apps** in the top navigation.
2. Find **TestFirst** in the list and click it. You’ll see a message: *“For this app to display, you need to allow the app to access Atlassian products on your behalf.”*
3. Click **Allow Access**. A new tab will open with permission details.
4. Review the permissions and click **Accept**. The tab will close and the **TestFirst app welcome page** will load.
5. On the welcome page, click the link to open the **TestFirst Admin Panel**.
6. On the **Admin Panel**, enter the credentials for the **TestFirst user** created for this integration.
7. Click **Login**. A confirmation message will appear, and the Jira–TestFirst integration will become active.\
   You can now view **linked TestFirst test cases** directly from Jira issues.

***

### Best Practices

* ✅ **Use a dedicated TestFirst account** for Jira integration.\
  Using a personal or shared user account may cause unstable connections between Jira and TestFirst.
* 🔑 **Create a new user** by signing up [here](https://www.testfirst.com/plans) and ask your **Administrator** or **Owner** to invite that user to your organization.
* 🚫 **Google authentication is not supported** in the Jira app.\
  If your TestFirst account was created with Google login, reset your password to enable login with credentials.
* 🏢 If the user belongs to multiple organizations, an additional screen will appear during login allowing you to select the organization. Click **Proceed** after selecting the correct one.

{% hint style="info" %}
After setup, all users in your Jira project will be able to view **linked TestFirst test cases** directly from issue pages — no additional configuration is required.
{% endhint %}

***

## Configure Jira integration in TestFirst