If your team runs automated tests in Katalon Studio and relies on Jira test management to track defects, you already know the friction: a test fails, a tester screenshots the error, opens Jira, creates a ticket manually, pastes in the log, and attaches the file. Multiply that by dozens of failures per sprint, and you have a process that eats hours and invites human error.
Katalon Jira integration eliminates that bottleneck entirely. With the official Jira Integration plugin, every failed test step exposes a one-click bug icon. A single click opens a pre-populated Jira issue - complete with test case name, screenshots, and logs - right from the Katalon results panel.
The result? Faster automated test defect tracking, zero manual transcription errors, and a single source of truth that links every Jira ticket back to the exact test that found it. For any team serious about Katalon Studio bug reporting, this integration is non-negotiable. For the most current UI reference and release-specific notes, see the official Katalon documentation.
Before diving into how to integrate Katalon Studio with Jira Cloud, make sure you have the following in place:
The first part of the Katalon plugin setup is getting the Jira Integration plugin from the Katalon Store. It is not bundled with the IDE, so installation is a separate step.
Open your browser and navigate to store.katalon.com.
Log in with your Katalon credentials.
Type "jira" in the search bar and press Enter.
From the results, click the Jira Integration tile - the one showing ~12.9K downloads and the four-star rating. Do not confuse it with the "AIO Tests for Jira Integration" plugin.
Version Compatibility Note:
Always verify on the plugin's Requirements tab before installing - mismatched versions are the number-one cause of a broken integration after a Studio upgrade.
You will also need to install the Katalon Test Automation for Jira plugin directly from the Atlassian Marketplace. This enables the two-way sync between Katalon and Jira at the platform level and is required for the full integration to work.
Installing from the store does not automatically activate the plugin inside the IDE. This is a step many guides skip, and it is why the Jira icon never shows up for some users.
Katalon will fetch all plugins linked to your account. A Plugins dialog will appear listing every installed plugin with its version and status. Confirm that Jira Integration (your installed version) shows Status: Success before moving on.
Once the plugin loads successfully, open your project's Jira settings directly from the menu.
In Katalon Studio, go to Projects > Settings > Plugins > JIRA.
This opens the JIRA configuration panel within your project settings. Note that Jira integration is scoped to the individual project - if you need to integrate Jira with another Katalon project, you will need to repeat these steps for that project.
Inside the JIRA settings panel:
Check the Enable integration checkbox at the top.
Under the Authentication section, fill in:
This is the step most tutorials gloss over, and it is where most setups break. Understanding the Jira API token Katalon requirement is critical: Jira Cloud discontinued password-based authentication for API access. You must generate a token.
Here's exactly how to do it:
Do not close this dialog until you have copied the token. Atlassian shows it exactly once. Store it immediately in a password manager or a secure note. If you lose it, you will need to generate a new one and update your Katalon settings.
Back in Katalon Studio's JIRA Project Settings:
A successful connection is confirmed when the Submit Options dropdowns below populate with your Jira projects and issue types. If they remain empty, your credentials did not authenticate - revisit the token and Server URL.
With a live connection, configure default submission behavior:
| Setting | Recommended Value |
|---|---|
| Default JIRA Project | Your QA or sprint project (e.g., Locator Phase2) |
| Default JIRA Issue Type | Bug |
| Use Test Case name as Summary | ✓ Checked |
| Attach Screenshot to JIRA ticket | ✓ Checked |
| Attach Log to JIRA ticket | ✓ Checked |
| Automatically submit test result | ✓ Checked (enables hands-free defect tracking) |
Click Apply and Close. Your Jira integration with Katalon is now fully operational.
This is the section that makes everything above worth it. Here is the complete workflow for Katalon Studio bug reporting after a test run.
Execute any test suite or test case in Katalon Studio. Once the run completes, open the Results panel.
For every failed test case, a small Jira bug icon appears to the right of the row. This is your one-click gateway to submit bugs from Katalon to Jira automatically.
Click the icon to open the Linked JIRA Issues dialog.
The dialog presents three options:
Katalon opens the Jira Create Issue form with the following already populated:
Add any additional context - steps to reproduce, environment, severity - and click Create. The ticket is filed in Jira instantly, and a link back to it appears in Katalon's results panel, completing the loop between automated test defect tracking and your Jira test management workflow.
Beyond submitting bugs from test results, the integration lets you link Jira issues directly to individual test cases in Katalon Studio's Test Explorer. This is useful when you want to map a specific test case to an existing Jira ticket - whether for traceability, BDD requirement linking, or audit purposes.
Problem: Jira issue cannot be found:
Reason/Workaround: You have either entered the wrong issue key or the Jira issue is no longer available from your fetched account. Ensure that you have entered the correct Jira issue key.
In Katalon Studio, go to the Test Explorer and find the test case you want to update.
Click on the Integration tab.
Select Remove Linked Issue.
When the confirmation dialog appears, click Remove to confirm.
If your team writes BDD scenarios in Jira, you can pull test cases directly into Katalon Studio using Jira Query Language. This is one of the most powerful - and underused - aspects of the integration.
Once imported, the test case name reflects the Jira ticket summary and the description contains the Jira ticket content. If you imported BDD feature files, Katalon Studio creates a corresponding feature file in the Include/Feature folder. Note that you can only import test cases from a Jira ticket once - this action cannot be repeated for the same ticket.
If you conduct BDD testing, you can view the results directly in Katalon True Platform.
Leverage JQL for two-way traceability. The integration is bidirectional. Navigate to Jira > Import Test Case from JIRA JQL to pull Jira issues directly into Katalon as test cases. This is a powerful feature for requirement-based testing.
Automate fully with CI pipelines. Enable "Automatically submit test result" if you run nightly pipelines. Combined with Katalon's CI/CD pipeline integrations, every failure auto-creates a Jira ticket with zero human intervention required. This is what truly hands-free automated test defect tracking looks like.
Use True Platform's two-way Jira sync for full lifecycle visibility. Beyond the Studio plugin, Katalon True Platform's Test Management component syncs Projects, Releases, Requirements, and Defects directly from Jira. This means requirement traceability and release readiness are always up to date - no manual reconciliation between your defect tracker and your test management layer.
Remember the project scope. Jira integration is configured per Katalon project. If you work across multiple projects, each one needs its own integration setup - a quick repeat of the steps above, not a new plugin install.
Set an API token rotation reminder. A lapsed Jira API token for Katalon silently kills the integration mid-sprint with no obvious error. Add a calendar reminder two weeks before your token expires and rotate it proactively.
Encrypt your credentials. The "Encrypt authentication data" checkbox matters whenever your .prj file is committed to a shared Git repository. Don't skip it.
Validate plugin version before every Studio upgrade. This is the single most common reason the integration breaks. The plugin version requirement changes between Katalon Studio 8.x and 9.x - always check the Requirements tab on the Katalon Store listing before you upgrade.
| Problem | Likely Cause | Fix |
|---|---|---|
| Connect button fails | Wrong API token or Server URL | Re-generate the token; remove any trailing slash from the URL |
| Bug icon not visible in results | Plugin not loaded | Reload Plugins from the user icon; confirm Status: Success |
| Default JIRA Project dropdown is empty | Authentication not connected | Click Connect first - dropdowns only populate after a successful auth |
| Token expired error | Jira API token past expiration | Generate a new token at id.atlassian.com and update Project Settings |
| "Jira issue cannot be found" when linking | Wrong issue key entered, or the Jira issue no longer exists in your account | Verify the issue key is correct and that the Jira account used has access to that project |
| Plugin installed in Store but missing in Studio | Studio/plugin version mismatch | Verify the correct plugin version for your Studio version (8.x vs. 9.x) |
Getting Katalon Jira integration running is a one-time, under-ten-minute setup that pays dividends every single sprint. By learning how to integrate Katalon Studio with Jira Cloud, you eliminate the manual bridge between your automated test results and your defect backlog - and you give every stakeholder, from developer to product manager, a clear, traceable line between a failing test and the ticket being worked.
Here is the complete setup at a glance:
If Katalon Studio bug reporting and automated test defect tracking are priorities for your team - and they should be - this integration is the most direct path to getting there. For teams on Katalon True Platform, the bidirectional Jira sync at the test management layer extends that traceability across your entire quality lifecycle, not just individual test runs.