Configuring Katalon Studio for the Web automation test project

Katalon Studio supports functional testing of web applications on Internet Explorer, Edge, Chrome, Firefox and Safari.

This tutorial explains how to setup a test project in Katalon Studio. We assume that you are familiar with general principles of automated testing and have minimal knowledge of the Katalon Studio IDE.

Internet Explorer Configurations

Skip this section if you do not wish to run your automated tests on Internet Expolorer. Otherwise, you need the following setup:

– For IE 7 to IE 11, set the Security level for all zones (Internet, Local Intranet, Trusted sites and Restricted sites) to the same value. To access this setting, choose Internet Options from Control Panel of Windows, then switch to the Security tab:

Internet Options

– For IE 10 or later, uncheck Enable Enhanced Protected Mode* in the Advanced tab.

Enable Enhanced Protected Mode

– Set the Zoom level on IE to 100% so that native mouse events can be identified correctly.

Zoom level on IE for web automation

– For IE 11, you need to set a registry entry on the target computer so that the Katalon driver can maintain a connection to the IE instances that it creates.

1.Type ‘regedit‘ into Command Prompt to open Registry Editor

2. Locate the FEATURE_BFCACHE subkey (create the FEATURE_BFCACHE subkey in case it is not there):

2.1 For 32-bit Windows, the key is at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE.

2.2. For 64-bit Windows, the key is at HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE.

3. Inside this subkey, create a value named iexplore.exe with the Type as REG_DWORD and the Data as 0.

create a value named iexplore.exe

Katalon Addon for Chrome

Katalon Utility, a Katalon addon for Chrome, is required if capturing objects on your active Chrome browsers. You can install this Katalon addon for Chrome from here. Refer to Web Object Spy and Record & Playback for more details.

Katalon Utility

Port Configuration

This configuration allows you to decide which port to be used for sending data between Katalon Utility and Katalon Studio.

1. Once Katalon Utility is added to Chrome, right-click on its icon at the top right of your browser and open the Options setting to specify a preferred port to communicate with Katalon Studio (default value is 50000).

open the Options setting

2. Open preferences for Katalon Utility in Katalon Studio by accessing Window > Preferences > Katalon > Utility Addon. Enter the same port number to be used for communicating with Katalon Utility.

Katalon Utility Addon

Proxy Settings

There may be a situation when your machine is setup within a restricted network with a policy to only allow Internet connection through a proxy server. In such a case, proxy settings can be configured from Preferences > Proxy. The settings affect both WebUI and WebService test execution. (Contact your network administrator to have necessary information for these settings).

Katalon Proxy Settings

Certificate Settings

Users may find their computers operating in a network that requires some certification in order to access the Internet.

Katalon Studio supports the capability to bypass certificate validation so that users with restricted network policies can work with Katalon Studio as usual. This setting can be found from Project > Settings > Network. This setting affects both WebUI and WebService testing.

Katalon Certificate Settings

Desired Capabilities

You can add and modify Desired Capabilities to set the properties of browsers for test execution.

To define Desired Capabilities for local execution using Chrome, Firefox, IE, Safari or Edge, please access Project > Settings > Execution > Default > WebUI > Chrome (or Firefox, IE, Safari, Edge)

The example below show a desired capabilities setting for the web browser to disable info bar.

Katalon Desired Capabilities

Refer to to know which properties of each web browser are supported by Selenium.

Notes: in case you want to have more configuration about desired capabilities (e.g., setup desired capabilities for specific web execution on remote machines), please refer to Execution Settings for more details.

External Library

With this setting, you can add or remove your external libraries. Please access the setting from Project > Settings > External Libraries.

Katalon External Library

  • Add: Click and browse your .jar file to add a library to your external libraries. The selected library will be copied to the Drivers folder in the Katalon project.
  • Remove: Click to remove existing libraries. They will be removed from the Drivers folder for a Katalon project

The added libraries can be imported and utilized in the Script View of test cases:

Katalon Studio Script View

Database Settings

These settings allow you to define the global database connection to be used in several features of Katalon Studio such as defining Test Data or Checkpoints. You can access these settings from Project > Settings > Database.

Katalon Database Settings

The dialog includes the following fields:

Field Description
Username The username to authenticate with connected database server
Password The password to authenticate with connected database server
Connection URL The connection string of database server. Katalon Studio supports following databases:

  • MySQL
  • SQLServer
  • Oracle
  • Postgre

Git Integration

Katalon Studio supports Git integration to facilitate team collaboration. Refer to this guide on how to enable it.

Post-execution options

Users can specify what to do next when a test execution finishes. The setting can be accessed from Windows > Katalon Studio Preferences > Katalon > Execution

Katalon Post-execution options

The options include:

Field Description
Default execution The default environment that Katalon Studio will use to execute automation test.
Default load timeout The default timeout period (in seconds) that Katalon Studio will wait for the application under test to be loaded during the execution of tests.
Post-Execution Options These options determine the actions that Katalon Studio will perform after executing tests.

  • Notify me: Specify whether you want to send email notification.
  • Open report: Specify whether the report generated is opened immediately.

Terminate drivers: Specify whether any driver remaining after execution will be terminated.


81% people found this helpful
Related testing tools
Katalon Studio
Best automation solution for software testing team. Completely free!
Katalon Recorder
Ultimate Selenium IDE to record, play, and debug app. Fast and extensible!
Katalon Analytics
Bring you to the next level of test execution reports. Smart and seamless solution!
Scroll up