Katalon Automation Recorder Quickstart

Katalon Recorder quickstart

Katalon Recorder is the Selenium IDE-compatible record & playback tool for browser automation testing. You can use it to record, debug, execute & manage test cases, and export test suites to multiple programming languages such as C#, Java, Ruby, Python, Groovy, Robot Framework, etc.

While Katalon Recorder is already designed to ease the stress of automation testing for everyone, we want to further assist you in the onboarding process with this quick user guide. Continue reading for all essential information, features, and instructions to make the best use of the tool!

Katalon Recorder User Guide

Katalon Recorder main UI contains four sections as follow:

  • Main Toolbar
  • Test Explorer
  • Test Case Details View
  • Log/Reference/Variable/Self-healing

1. Main Toolbar

Katalon Recorder’s main toolbar contains buttons to help you to manage the web recording process.

Actions sidebar

Action Side Bar

Open Test Suite Load a test suite from the filesystem to KR
Sample Projects Add more than a dozen built-in Sample Projects to get started
Export Export KR tests to Katalon Studio, Selenium WebDriver, New Relics, App Dynamics
Backup Data Backup your test suites to TestOps to restore them later
Upload Report Upload your test executions to TestOps to have analytics, report, and insights


Tool Bar

Record Record your tests
Play Execute selected single test case
Play Suite Execute selected test suite
Play All Execute all test suites
Pause/Resume Pause and Resume current execution
Stop Stop recording on the current execution
Report (moved to Action sidebar) Upload logs to Katalon TestOps to keep track of execution history
Export Export current test suite/test case to various scripting languages and framework
Speed Adjust play speed
Setting Port configuration for Katalon Studio Users. Allow users to change the default port used by Katalon Studio to communicate with the active browser
Help icon Katalon Recorder Support Resources include: User Manual, Videos, Community, and Free Advanced Automation
Github icon Go to Github Dashboard
Extended features  Look at your Daily Usage or opt for Essential Product Tours

2. Test Explorer

Test Explore

Test Suites Show the number of Passed & Failed tests
Dynamic Test Suites A dynamic test suite lets you execute test cases with certain tags dynamically. 
Test Data CSV and JSON files are fully compatible with Katalon Recorder native commands.


Click + to add CSV and JSON files to your workspace. 

Extension Script Extend Katalon Recorder’s functionality by providing custom commands and locators. 
Profiles (Global Variables) Click + to create a new profile in your workspace


Add global variables to your profile

Right-click on the profile and choose Use this in a test case

Editing test case

3. Test Case Details View

Katalon Recorder displays the recorded test script in the test case window. All commands and parameters are shown in table format. You can drag and drop any test step to reorganize the test case order

a. Editing Test Case

Edit Test Case step 1

Edit Test Case Step 2

The Command field shows a drop-down menu

In the Command, Target, Value entry fields, you can see the information of the currently selected command, edit the recorded commands, or add new commands in any given step. 

The Command field will show a drop-down menu that suggests commands based on the input. Katalon Recorder supports most of the common Selenium commands, including:

  • Actions: Commands that reproduce user interaction on the application under test.
  • Accessors: Commands are used to store the results in variables.
  • Assertions: Commands that verify the application under test behave as expected.

For more details about Selenium commands, refer to this link.

For a more detailed list of support commands, refer to this document.

b. Context Menu

Context menu 1 Context Menu 2

Right-click on test case details views to display the Context menu. Users can perform most of the essential actions for command at any preferred test step:

Manage test cases

Add Command Insert a new command in the currently selected step
Delete Command Remove a single selected command
Delete All Command Remove all commands of the currently selected test case
Copy Command Copy the currently selected command
Paste Command Paste a command at a particular test step


Toggle Breakpoint Set a breakpoint to stop at a specific command for debugging purposes


Play this command Run a single command for prompt feedback
Play from here Run from a single command till the end of the script

4. Log/Reference/Variable/Self-healing

Log Reference Variable Self Healing 1 Log-Reference-Variable-Self-healing-2

  • Log: This tab shows the real-time report/log of the test execution. All execution errors, information messages, and execution progress are displayed here.
  • Reference: The Reference tab displays the detailed documentation of the selected command. The information helps users to verify the types and number of parameters of each command.
  • Variables: The Variables tab displays detailed information (name, target, and values) on the currently selected command while test execution is in progress.
  • Self-healing: Self-healing automatically detects valid and broken locators to ensure the test script is executed without interruption. For more information, check out this article

Katalon Recorder FAQs

  • Is Katalon Recorder free?

Katalon Recorder is a free web extension available on Chrome, Firefox, or MS Edge store. To install it, head to your browser store, sign in with your Katalon account (free sign-up), and enjoy all features of Katalon Recorder. 

Add to Chrome button

Add to Firefox button

Add to MS Edge button


  • Does Katalon Recorder have a professional development team?

Katalon Recorder has a dedicated development team that is constantly listening to our users’ needs. We optimize existing features through monthly, sometimes weekly, updates and commit to delivering quality browser automation solutions to individuals and teams at any scale. 

For more information on FAQ & Troubleshooting Instructions, visit this document.

Katalon Recorder Release Notes

For more details on previous versions of Katalon Recorder, please visit our Release Notes


The Selenium alternative
that makes a difference.