Skip to main content

Jira Integration

Connect your Jira workspace to TMS to sync test cases with Jira issues, automatically create bugs from failed tests, and keep statuses in sync across both platforms.

What You Can Do​

  • Link test cases to Jira issues -- See related Jira tickets directly from TMS test cases
  • Auto-create Jira bugs -- When a test fails, TMS can automatically create a Jira bug with failure details
  • Two-way status sync -- When a Jira issue moves to "Done", the linked TMS test case status updates automatically (and vice versa)
  • Sync test execution results -- Push test run results to Jira as comments or custom fields

Connect Jira to TMS​

TMS uses OAuth 2.0 to connect to your Jira workspace securely. You don't need to create your own OAuth app -- TMS handles this for you.

Step 1: Open Integration Settings​

  1. In TMS, go to Settings > Integrations
  2. Find Jira in the list and click Connect

Step 2: Authorize TMS​

  1. You'll be redirected to Atlassian's authorization page
  2. Select the Jira workspace you want to connect
  3. Review the permissions TMS is requesting:
    • Read projects and issues -- TMS needs to read your Jira data to display linked issues
    • Create and update issues -- TMS needs this to create bugs and sync statuses
    • Read user information -- TMS needs this to map users between the two systems
  4. Click Accept to authorize

Step 3: Configure the Connection​

After authorizing, you'll return to TMS. Configure the connection:

  1. Default Jira Project: Select the Jira project where bugs will be created
  2. Issue Type for Bugs: Choose the issue type (usually "Bug")
  3. Auto-create bugs on failure: Toggle on/off
  4. Status mapping: Map TMS statuses to Jira statuses
TMS StatusJira Status
PassedDone
FailedTo Do
BlockedBlocked
SkippedWon't Do
  1. Click Save
Multiple Jira projects

You can map different TMS projects to different Jira projects. Go to each TMS project's settings to configure its Jira project mapping.

From TMS​

  1. Open a test case in TMS
  2. In the sidebar, find Linked Issues
  3. Click Link Jira Issue
  4. Search by issue key (e.g., PROJ-123) or title
  5. Select the issue and click Link

Bulk linking​

  1. Go to Test Cases list view
  2. Select multiple test cases using checkboxes
  3. Click Actions > Link Jira Issues
  4. Enter the Jira issue key to link to all selected test cases

Auto-Create Bugs from Failed Tests​

When enabled, TMS automatically creates a Jira bug when a test fails. The bug includes:

  • Test case name and ID
  • Error message and stack trace
  • Screenshot (if captured by the test runner)
  • Link back to the TMS test result
  • Environment and browser information

Configure auto-bug creation​

  1. Go to Settings > Integrations > Jira
  2. Under Automation, toggle Auto-create bugs on test failure
  3. Configure:
    • Jira Project: Where to create bugs
    • Issue Type: Bug (or your custom type)
    • Priority mapping: Map TMS test priority to Jira priority
    • Assignee: Auto-assign to a team member or leave unassigned
    • Labels: Add labels like auto-tms, regression-failure
    • Duplicate detection: TMS checks for existing open bugs before creating a new one

Example auto-created bug​

Title: [TMS] Test Failed: Login with expired credentials (TC-103)

Description:
Test case TC-103 "Login with expired credentials" failed in test run #847.

Environment: staging
Browser: Chrome 120
Run: Playwright: 2026-02-20 14:30:00

Error:
  Expected: "Account expired" message
  Actual: Page showed "Internal Server Error"

Stack trace:
  at LoginTest.spec.ts:45:12
  at ...

View in TMS: https://tms.yourcompany.com/org/1/projects/12/runs/847/results/3021

Labels: auto-tms, regression-failure

Two-Way Status Sync​

When enabled, status changes flow in both directions:

Jira to TMS​

  • Jira issue moves to Done -- linked TMS test case marks latest result as Passed
  • Jira issue moves to In Progress -- no TMS change (informational)
  • Jira issue moves to Won't Fix -- linked TMS test case marks as Skipped

TMS to Jira​

  • TMS test passes -- linked Jira bug transitions to Done (if all linked tests pass)
  • TMS test fails -- linked Jira bug transitions to Reopened

Configure sync​

  1. Go to Settings > Integrations > Jira
  2. Under Sync, toggle Two-way status sync
  3. Configure the status mapping (see table above)
  4. Choose sync direction: Jira to TMS, TMS to Jira, or Both
Webhook setup required for real-time sync

For real-time status sync from Jira to TMS, your TMS administrator needs to configure a Jira webhook. Go to Settings > Integrations > Jira > Webhooks for setup instructions.

Without webhooks, TMS polls Jira every 15 minutes for changes.

Disconnect Jira​

  1. Go to Settings > Integrations > Jira
  2. Click Disconnect
  3. Confirm the disconnection

Existing links between test cases and Jira issues are preserved but become read-only. No more syncing occurs until you reconnect.

Verify It Works​

  1. Connect Jira from Settings > Integrations
  2. Open a test case in TMS
  3. Click Link Jira Issue and link it to an existing issue
  4. Verify the linked issue appears in both TMS and Jira
  5. (Optional) Run a failing test and confirm a bug is auto-created in Jira
Common issues
  • "Authorization failed": Make sure you selected the correct Jira workspace during OAuth and that you have admin access
  • Can't find issues: The search only returns issues from projects you have access to in Jira
  • Bug not auto-created: Check that auto-bug creation is enabled and the Jira project/issue type mapping is configured
  • Sync not working: Verify webhooks are configured for real-time sync, or wait up to 15 minutes for poll-based sync