Skip to main content
Ask AI

Jira Integration

The Jira integration bridges test failures and bug tracking. Connect Jira to link any test session to an existing issue or create a new one pre-filled with failure context — without switching tools.

What this integration enables​

  • Link sessions to issues — Connect a test case failure to an existing Jira issue.
  • Quick-create Jira issues — Create a new Jira issue directly from a test session, pre-filled with error context.
  • AI-assisted issue matching — AI Insights uses the Jira connection to surface existing tickets that match a detected failure pattern.
  • Issue status in workspace — Linked Jira issues show their current status (To Do, In Progress, Done) directly in the session workspace.

Connecting Jira​

  1. Navigate to Settings → Integrations.
  2. Click Connect on the Jira card.
  3. In the connection dialog, provide:
    • Your Jira instance URL (e.g. https://yourcompany.atlassian.net)
    • A Jira API token (generated in your Atlassian account settings)
    • Your Jira email address
  4. Click Save to verify the connection.
API token vs. password

Jira no longer accepts account passwords for API access. You must use an API token generated from your Atlassian account settings.

Linking a session to an existing issue​

  1. Open a test case in the Session Workspace or Test Case Detail.
  2. Click the Jira tab in the workspace panel.
  3. Click Link to existing issue.
  4. Search for the issue by key (e.g. PROJ-123) or title.
  5. Select the issue and click Link.

The issue key and summary are displayed in the Jira tab for future reference.

Quick-create a Jira issue​

  1. Open a test case in the Session Workspace.
  2. Click the Jira tab.
  3. Click Create issue (or use the Quick Create sheet which opens from the session detail toolbar).
  4. The create form is pre-filled with:
    • Summary — The test case name
    • Description — Error message, stack trace, and a direct link to the session in TestRelic
    • Project — The last used Jira project (configurable)
    • Issue type — Bug (default)
  5. Edit any fields as needed and click Create.

The newly created issue is automatically linked to the session.

AI insights and Jira​

When AI Insights analyzes a session (Growth plan), it queries the Jira integration to find issues that match the detected failure signature. Matched issues are displayed in the Insights panel with their current status, helping you avoid creating duplicate tickets.

Permissions required​

The Jira API token must belong to an account with:

  • Browse projects — to search for issues
  • Create issues — to create new bugs
  • Edit issues — optional, used when linking sessions adds comments to existing issues