Blog TOC Banner

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 SuiteLoad a test suite from the filesystem to KR
Sample ProjectsAdd more than a dozen built-in Sample Projects to get started
ExportExport KR tests to Katalon Studio, Selenium WebDriver, New Relics, App Dynamics
Backup DataBackup your test suites to TestOps to restore them later
Upload ReportUpload your test executions to TestOps to have analytics, report, and insights


Tool Bar

RecordRecord your tests
PlayExecute selected single test case
Play SuiteExecute selected test suite
Play AllExecute all test suites
Pause/ResumePause and Resume current execution
StopStop recording on the current execution
Report (moved to Action sidebar)Upload logs to Katalon TestOps to keep track of execution history
ExportExport current test suite/test case to various scripting languages and framework
SpeedAdjust play speed
SettingPort configuration for Katalon Studio Users. Allow users to change the default port used by Katalon Studio to communicate with the active browser
Help iconKatalon Recorder Support Resources include: User Manual, Videos, Community, and Free Advanced Automation
Github iconGo to Github Dashboard
Extended features Look at your Daily Usage or opt for Essential Product Tours

2. Test Explorer

Test Explore

Test SuitesShow the number of Passed & Failed tests
Dynamic Test SuitesA 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 ScriptExtend 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 CommandInsert a new command in the currently selected step
Delete CommandRemove a single selected command
Delete All CommandRemove all commands of the currently selected test case
Copy CommandCopy the currently selected command
Paste CommandPaste a command at a particular test step


Toggle BreakpointSet a breakpoint to stop at a specific command for debugging purposes


Play this commandRun a single command for prompt feedback
Play from hereRun 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

Start your free trial now!