Jira Integration

Connect your Jira workspace to ProvaLab.io 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 ProvaLab.io test cases
• Auto-create Jira bugs -- When a test fails, ProvaLab.io can automatically create a Jira bug with failure details
• Two-way status sync -- When a Jira issue moves to "Done", the linked ProvaLab.io 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 ProvaLab.io

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

Step 1: Open Integration Settings

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

Step 2: Authorize ProvaLab.io

1. You'll be redirected to Atlassian's authorization page
2. Select the Jira workspace you want to connect
3. Review the permissions ProvaLab.io is requesting:
   • Read projects and issues -- ProvaLab.io needs to read your Jira data to display linked issues
   • Create and update issues -- ProvaLab.io needs this to create bugs and sync statuses
   • Read user information -- ProvaLab.io 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 ProvaLab.io. 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 ProvaLab.io statuses to Jira statuses

ProvaLab.io Status	Jira Status
Passed	Done
Failed	To Do
Blocked	Blocked
Skipped	Won't Do

5. Click Save

Multiple Jira projects

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

Link Test Cases to Jira Issues

From ProvaLab.io

1. Open a test case in ProvaLab.io
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, ProvaLab.io 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 ProvaLab.io 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 ProvaLab.io 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: ProvaLab.io 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 ProvaLab.io: 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 ProvaLab.io

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

ProvaLab.io to Jira

• ProvaLab.io test passes -- linked Jira bug transitions to Done (if all linked tests pass)
• ProvaLab.io 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 ProvaLab.io, ProvaLab.io to Jira, or Both

Webhook setup required for real-time sync

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

Without webhooks, ProvaLab.io 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 ProvaLab.io
3. Click Link Jira Issue and link it to an existing issue
4. Verify the linked issue appears in both ProvaLab.io 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