Katalon Compact Utility


In restricted environments, unpacked extensions are disabled as a security feature. In that case, using the Spy, Record, and Smart Wait with Chrome might prompt this error: "Loading the unpacked extension is disabled by the administrators."

It is possible to use the packed extension Katalon Compact Utility as an alternative. The extension is available on Chrome Web Store.

This article will show you how to install the extension, configure your Profile, and use the Spy, Record, and Smart Wait in Katalon Studio.


This utility is associated with your Chrome Profile, which means you can only have one active session at any given time.

Installing Katalon Compact Utility

  1. Open Chrome. Make sure you use the Profile you want to use the Spy, Record, or Smart Wait with.

  2. Navigate to the Chrome Web Store page for this extension: Katalon Compact Utility.

  3. Download and install Katalon Compact Utility.

  4. Make sure the extension is now active. You can find Google Support instructions to manage your Chrome extensions here: Install and Manage Extensions.

Configuring and Using the Compact Utility with Chrome Profile

The next steps will help you associate your Chrome Profile with the Spy, Record, and Smart Wait functions in Katalon Studio.

Finding your Chrome Profile in the User Data Directory

There are multiple Profiles in a given User Data Directory. This section will help you find the name of the correct one.

  1. Open Chrome with the Profile you previously used to install Katalon Compact Utility. In the address bar, type chrome://version and press Enter.

  2. The line Profile Path: now displays the path to your active Profile. For example: C:\Users\your_username\AppData\Local\Google\Chrome\User Data\your_profile_name.

  3. Copy your profile name.

  4. Close Chrome.

Configuring and using Katalon Compact Utility with Chrome Profile

To configure and use Katalon Compact Utility, you need to update the Desired Capabilities. Do as follows:

  1. Go to Project > Settings > Desired Capabilities.

  2. In the Desired Capabilities section, select Web UI > Chrome.

  3. Click Add to create a new capability named args, for which the type is List.

  4. To add elements to your list, in the Value column of the capability you've created, click on the ... button.

  5. The List Properties Builder dialog appears. Click Add to create two elements as below:

Type Value

For Windows: user-data-dir=C:/Users/<your_username>/Desktop/User Data
For Mac OS: user-data-dir=/Users/<your_username>/Library/Application Support/Google/Chrome
String profile-directory=<your_profile_name>
  1. Execute feature by default Chrome option.


    Before executing, make sure you log out of all your Chrome sessions. This extension currently does not support multiple sessions.

See also: