As QA teams begin adopting Automation Testing to streamline processes like Regression Testing, one of the initial steps is often integrating their existing test management tools with an automation framework. This post provides a guide on how to integrate qTest, a popular test management tool, with Katalon, an automation testing framework.
﷽
Background
qTest is a comprehensive test management tool that provides features such as test planning, execution, reporting, and integration with other tools. Before adopting automation testing, most QA teams rely heavily on manual testing and use test management tools to plan, execute, and track their tests—entirely manually. Over time, this leads to hundreds or even thousands of test cases being stored in the test management tool.
So, when the time comes to shift towards automation, it’s essential to integrate your test management tool with your automation framework. This ensures that all those existing test cases can be effectively reused and managed within the automated testing workflow.
This notes will focus on how to integrate qTest with Katalon using the qTest plugin for Katalon.
Download qTest Plugin
To integrate qTest with Katalon, you need to download the qTest plugin for Katalon. You can find the plugin on the qTest website: https://store.katalon.com
.

Please note that you need to have a Katalon account to download the plugin. The account must be same as Katalon Studio account that you use to access the plugin.
Configure qTest Plugin for Katalon
Once you have downloaded the plugin, you need to configure it with your qTest account in the Katalon Studio. Follow the steps below to configure the plugin:
- 
Open the Katalon Studio in your local machine.
Some tips are:
- Make sure your Katalon Studio account is the same as in Katalon Store when you download the qTest plugin.
 
 - 
To verify the plugin is installed, click user icon in the top right corner of the Katalon Studio. Try to reload the plugin by clicking the “Reload Plugins” button.
wait until the plugins list is reloaded. You will see the qTest plugin in successfully installed.
then close the plugin popup. - 
Click on the
Projectthen click on theSettingsbutton.
 - 
The
Project Settingspopup will open. Expand on thePluginsthe click on theqTest.
at this popup, you need to fill the following fields, please follow the instructions below carefully. Since I have spent some time to understand, how to configure the qTest plugin correctly. Otherwise, you might face some issues, like the qTest project won’t be loaded.

 - 
Fill the following fields:
- Tick the 
Enable Integration. - Fill the 
Tokenwith your qTest’s token.- The 
qTesttoken can be found in your qTest account. - Choose the qTest project (any project, since the 
arrow down iconwill shown if you have already selected a project), then you will find thearrow down iconon the right side. Click on thearrow down icon.
 - You will be redirected to the 
Download qTest Resourcespage. Click on theAPI & SDKbutton.
 - Now you will see the qTest 
Token. Then copy the token value.
 
 - The 
 - Finally the popup should look like this:
You could tick some options in the Test ResultandReport formatbased on your needs. 
 - Tick the 
 - 
Click on the
Quick Setuptext on the top right side, based on image above. TheqTest Integration Setup Wizardwill open.
Fill the following fields:qTest Versionchoose the latest version. Now it’s 7 or higher.Server URLfill with your qTest server URL. For example https://Your_QTest_Subdomain.qtestnet.comUsernamefill with your qTest username.Passwordfill with your qTest password.Encrypt authentication datatick the checkbox. Since this recommendation from Katalon.
 - 
Click on the
Connect accountbutton. Wait until the connection is successful.
 - 
Click on the
Nextbutton. If everything is correct, you will see theqTest Projectis loaded.
since I haven’t create any qTest project, the project list only show the qConnect - Sample Project. But is ok, since before I have an issue the qTest project won’t be loaded. Now, choose the project that you want to use then click on theNextbutton. - 
Now you will see the
qTest Moduleis loaded.
Choose the qTest Modulethat you want to use then click on theNextbutton. - 
Now choose the
Katalon Test Case Folderby default, the folder will be inKatalon Test Cases.Leave it default then click on theNextbutton.
 - 
Now choose the
Katalon Test Suites Folderby default, the file will be inKatalon Test Suites.Leave it default then click on theNextbutton.
 - 
Now tick some options in the
Katalon Execution Optionsbased on your needs.
Then click on the Nextbutton. - 
Now you will see the message
The Finish Upsuccessfully. Click on theFinishbutton.
 
That’s all my notes.
Reference:
- qTest Integration in Katalon (This docs missing step how to get qTest token, so it will be a little bit confusing)