> ## Documentation Index
> Fetch the complete documentation index at: https://documents.tmsone.app/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA

Connect a TMS ONE project to a Jira project to link test cases and defects to Jira tickets. Once connected, Jira tickets appear as a selectable field when creating test cases and defects.

***

## Connecting Jira to a project

Jira is connected at the **project level** from the Projects list.

### Step 1 — Open the Jira integration

1. Go to **Projects** from the top-level navigation
2. In the **Actions** column, click the **link icon** for the project you want to connect

<Note>
  The link icon turns green when Jira is already connected to a project.
</Note>

### Step 2 — Enter your Jira credentials

A modal opens. Fill in your Jira connection details:

<ParamField path="Jira Email" type="text" required>
  The email address associated with your Jira account.
</ParamField>

<ParamField path="Jira API Token" type="text" required>
  Your personal Jira API token. To generate one:

  1. Log in to your Atlassian account at [id.atlassian.com](https://id.atlassian.com)
  2. Go to **Security → API tokens**
  3. Click **Create API token**, give it a label, and copy the token
</ParamField>

<ParamField path="Jira Base URL" type="text" required>
  The root URL of your Jira instance.\
  Example: `https://your-domain.atlassian.net`
</ParamField>

Click **Connect**. TMS ONE validates your credentials and retrieves the list of Jira projects available to your account.

### Step 3 — Select a Jira project

A second step appears showing a dropdown of all Jira projects in your workspace. Select the Jira project you want to link to this TMS ONE project and click **Save**.

***

## After connecting

Once connected:

* When **creating or editing a test case**, a **Jira Tickets** multi-select field appears — search and link relevant Jira tickets
* When **creating a defect**, you can similarly link Jira tickets to track bugs across both tools
* When **generating automation scripts** in [Test Builder](/qa/test-builder), a Jira Tickets field is available in the script creation form

***

## Disconnecting Jira

To remove the Jira connection from a project, open the link icon modal again and click **Disconnect**. This removes the integration but does not delete any data in Jira or TMS ONE.

***

## What's next?

<CardGroup cols={2}>
  <Card title="Writing Test Cases" icon="pen" href="/qa/writing-test-cases">
    Link Jira tickets when creating test cases
  </Card>

  <Card title="Defect Management" icon="bug" href="/qa/defect-management">
    Track defects alongside Jira tickets
  </Card>
</CardGroup>