Katalon Studio Release Notes: Version 10.x

note

• The in-app upgrade from version 9.x to 10.x is not available. To download the latest version 10.x, go to Katalon website: Download Katalon Studio.
• Starting version 10.4.0, Windows Desktop app testing is officially available. We are using a new custom driver based on the FlaUI library, which supports spy, record, and execution of test cases—no separate installation required. For more information on feature availability, limitations, and supported application types, see the Katalon Studio Release Notes: Version 10.x.
• Custom keywords have been reintroduced in the free edition starting from version 10.0.0.
• Docker latest and latest-slim tags now point to the latest version 10.x.

Version 10.4.2 (Latest Version)

Release date: November 19, 2025

Overview

This patch release enhances StudioAssist Agent mode with new MCP tools, tool name limit handling, and retention of the previously selected mode. It also adds support for the latest browser versions, improves HTML report usability, and introduces a Copy as cURL option in API testing. The release includes multiple fixes across Mobile Recorder, Spy Web, Reporting, API Testing, Self-healing, and platform integrations to improve overall stability and performance.

Enhancements

• [StudioAssist | Agent mode]
  • Added 3 new MCP tools to extend StudioAssist’s automation capabilities, see Katalon built-in MCP servers:
    • Test Object
      • getTestObject: Retrieves detailed information about a test object from the Object Repository based on its ID in the current Katalon Studio project.
      • createTestObject: Creates a new test object in the Object Repository with a suggested locator strategy based on locator information. Supports Web, Mobile, Windows, and Web Service test objects.
      • updateTestObject: Updates an existing test object in the Object Repository based on its ID in the current Katalon Studio project. Supports Web, Mobile, Windows, and Web Service test objects.
  • Updated Katalon AI Service to use GPT‑4.1 mini for chat window (both Ask and Agent mode).
  • Improved the chat window to retain the previously selected mode when reopened, until Katalon Studio is closed.
  • Added AI Tag auto-append when using the updateTestScript MCP server tool to create or edit a test case.
  • Enforced a 64-character limit for tool names when StudioAssist Agent mode calls LLM APIs. (The combined length is calculated as {server_name}_ _ _{tool_name}.) Tools exceeding this limit are now auto-excluded from Agent mode, with UI warnings and guidance provided. This applies to all AI providers (OpenAI, Azure OpenAI, Gemini, AWS Bedrock).
• Added Chrome 142, Edge 142, and Firefox 145 compatibilities.
• [Reporting | HTML Report]
  • Added Expand All/Collapse All button and enhanced Search functions. See View test suite and test suite collection reports in Katalon Studio.
  • Added shortcut links in the Test Suite Collection (TSC) HTML report to directly access related Test Suite reports.
• [API testing] Added a Copy as cURL option and cURL commands in API request logs and reports (applies to REST/SOAP) to support API debugging. See View and customize execution log in Katalon Studio.

Fixes

• [Spy web] Fixed an issue where the Selected locator was not generated correctly when using the Attributes option.
• [StudioAssist]
  • Fixed an issue where, after logging in with an Offline license, closing and reopening Katalon Studio caused the StudioAssist configuration page to display an error instead of opening.
  • Fixed an issue where newer OpenAI models that previously worked in version 10.3.2 stopped functioning in Katalon Studio 10.4.0 and above, due to an unsupported temperature parameter being sent by default.
  • Fixed an issue where users could not check or uncheck individual tools in the MCP server within Agent mode’s Tool Settings.
• [Reporting]
  • [KRE] Fixed an issue where reports generated with the -reportFolder parameter were missing the TestSuite ID and duplicate reports were created.
  • [PDF Report] Fixed an issue where Test Case Information section are not aligned properly.
  • [HTML Report] Fixed and issue where the Profile field displays in the summary section of Test Suite Collection HTML report.
  • Fixed an issue where the value of the global variable platform could not be retrieved when running a Test Suite Collection with Katalon Runtime Engine (KRE) on Linux.
• [API Testing] Fixed an issue where search worked only for visible text in the Profile and Body tabs.
• [Mobile Recorder]
  • Fixed an issue where the Tap and Hold keyword did not show duration time input during recording.
  • Fixed an issue where the Tap and Hold input dialog still performed the action even after clicking Cancel button.
  • Fixed an issue where actions such as Tap and Tap and Hold keywords did not take effect on iOS devices when using TestCloud, remote, or local devices.
• [Katalon Studio] Fixed the StudioAssist tab appearing unexpectedly after selecting Learn How It Works post sign-up.
• [WebUI] Fixed an issue where the WebUI.authenticate keyword did not work on the BrowserStack remote platform.
• [Desired Capabilites] Fixed an issue where the profile.default_content_setting_values.notifications preference did not work correctly in Desired Capabilities for Katalon Studio 10.x.
• [Self-healing Web UI] Fixed an issue where Self-healing triggered but not displayed in Log Viewer box.
• [Integrations]
  • Resolved an issue where importing test cases from Jira X-Ray using the Jira Integration plugin failed because the plugin was calling a deprecated Jira API.
  • Fixed an issue where Katalon Studio 10.4.1 could not run tests on Kobiton Integration Devices and displayed the error: “Missing required information for Kobiton Execution.”.
• Fixed an issue where Katalon Studio 10.3.1 could not connect to Kobiton On-Prem.
• [Mobile testing] Fixed an issue where the locator for Mobile Test Objects did not update after adding, removing, or updating properties.
• [Self-healing] Fixed an issue when executing a test using Smart Locator, Self-Healing did not automatically switch to fallback selectors in the configured sequence (first locator → XPath → CSS).
• [WebUI] Fixed an issue where elements inside nested Shadow DOM could not be clicked.
• Fixed 14 security vulnerabilities (12 Medium & 2 Low severity issues).

Known limitations

• The Expand All button in the test suite HTML report might not expand all test cases right after opening, since it needs time to load all test case reports in that test suite report.
• The createTestObject and updateTestObject tools are not supported yet with AWS Bedrock provider.
• When using Gemini, the createTestObject and updateTestObject may not work as expected. As an alternative, you can generate a custom instruction in a .md file, focus on the type of object you want to create (e.g. web test object). Include a few examples from your real test objects in this instruction. Then attach that .md instruction along whenever you want to create/edit test object.

Version 10.4.1

Release date: November 4, 2025

Fix

[Chrome 142 Recorder Compatibility] Resolved an issue where Chrome 142 stopped supporting unpacked extension loading during runtime, which prevented users from recording test cases when launching new browser instances in Katalon Studio.

Version 10.4.0

Release date: October 27, 2025

Overview

Katalon Studio 10.4.0 introduces enhanced AI and automation capabilities.

This release includes the expansion of StudioAssist, which now features broader MCP Server and AI service provider integrations. New MCP Server tools for advanced automation and AI Test Case Failure Analysis have also been added to help you understand test failures better.

The update further includes the new Automated Code Migration (Beta) tool for major version upgrades, official support for Desktop App Testing utilizing the FlaUI driver, and a revised onboarding tour to guide users through Test Suite creation and execution.

New Features

• Introduced Automated Code Migration (Beta) tool to automatically update and fix your project's code for seamless major version upgrades (for example, from 8.x or 9.x to 10.x). This tool helps resolve breaking changes in BDD, Selenium, and dependencies. See Quick Guide for Auto Code Migration in Katalon Studio 10.4.0 (Beta).
• [Reporting] Added ${tsc_case_result_table} to include all test cases and their statuses from all test suites in a Test Suite Collection, and ${tsc_case_result_table_minimal} to include only failed or error test cases. See Share test reports via email in Katalon Studio.
• [StudioAssist]
  • Introduced AI Test Case Failure Analysis (not yet supported in KRE) to automatically analyze and summarize test failures using AI at both test case and test suite levels. The AI insights are displayed in HTML and email reports. See AI Failure Analysis in Katalon Studio.
  • Expanded StudioAssist’s AI provider options with AWS Bedrock compatibility. See StudioAssist Preferences.
  • Added Agent instruction and AI failure analysis to the StudioAssist Prompt Library for prompt customization. See Customize engineering prompts with Prompt Library.
  • Expanded StudioAssist MCP Servers:
    • Added 13 new MCP tools to extend StudioAssist’s automation capabilities. These tools let you programmatically create, update, and retrieve project assets such as test suites, custom keywords, BDD files, and test data. See Understanding MCP Servers for detailed usage and examples.
    • Available MCP tools include:
      • Test Suites
        • getTestSuite: Retrieve detailed information about a test suite.
        • createTestSuite: Create a new test suite with metadata and test cases.
        • updateTestSuite: Update an existing test suite with new metadata or test cases.
        • createTestSuiteCollection: Create a new test suite collection.
        • updateTestSuiteCollection: Update an existing test suite collection.
        • createDynamicTestSuite: Create a dynamic test suite with filters and metadata.
        • updateDynamicTestSuite: Update dynamic test suite settings or filters.
      • Custom Keywords
        • getCustomKeyword: Retrieve a custom keyword class file.
        • updateCustomKeyword: Update or rename an existing custom keyword.
      • BDD Files
        • createBddFeatureFile: Create a new Gherkin feature file.
        • updateBddFeatureFile: Update an existing feature file’s content or location.
      • Test Data
        • getTestDataList: Retrieve all available test data entities.
        • createInternalTestData: Create new internal test data with defined values.
  • StudioAssist now supports HTTP-based MCP servers which requires authentication (for example, Atlassian). See Supported MCP Servers.
  • Supported adding Atlassian SSE MCP Server to integrate with StudioAssist Agent mode. See Adding an external MPC Server.
  • Added TestOps MCP Server (enabled by default) for seamless connection and data exchange. See TestOps MCP Servers.
• [Onboarding] Revamped Onboarding Tour for Test Suite with an in-app tour introduces new users to running, and analyzing test suites. See In-app Onboarding Tours with Katalon Studio.
• [Desktop App Testing] Officially supported Desktop App Testing (via FlaUI driver) with improved performance and element handling. See Desktop app testing with FlaUI driver in Katalon Studion.
  • Added Select Option By Label keyword for Windows using FlaUI. See [Windows] Select Option By Label.
  • Added Windows.mouseOver keyword to the Windows keyword library, allowing users to execute mouse-over (hover) actions on Windows application elements. See [Windows] Mouse Over.
  • Added support for the WinAppDriver legacy capability ms:waitForAppLaunch to better handle slow-launching desktop applications, preventing immediate failures during the Windows.switchToWindowTitle keyword execution. See Desired Capabilitites.
  • Supported more element attributes in Windows Spy/Recorder.
• [API Testing] Introduced API Collection which supports authentication inheritance at the folder level, reducing repetitive configuration, improving consistency, and simplifying credential management. See API Collection for bulk managing authorization.

Enhancements

• Added Chrome 141, Edge 141, and Firefox 144 compatibilities.
• [Wait logic] Added a new toggle in Project Settings to enable or disable the enhanced waiting and checking mechanism. See Wait and Enhanced Waiting & Checking Keyword Logic.
• [Execution] Enhanced execution settings where users can configure per-platform (Web, Mobile, Windows) timeouts and per-keyword delays for more granular control. See Execution settings in Katalon Studio.
• [Mobile Testing]
  • Added support for iOS 26 and Android 16.
  • Supported horizontal and vertical Scroll To Text.
  • Supported Image Injection in Mobile Recorder by adding a new action 'Image Injection' in Mobile Recorder UI, and a new built-in keyword: Mobile.injectImage, currently supported in TestCloud only.
• [Web UI Self-healing] Added a UI display for auto-excluded keywords in Web Self-Healing, allowing users to review and selectively enable them for greater control over healing behavior.
• [Security]
  • Improved login logic to correctly handle trial license activation at the organization level.

Fixes

• [Desktop App Testing] Fixed an issue in FlaUI Driver where the tooltip displayed at the cursor blocked element detection.
• [WebUI] Fixed an issue in Shadow DOM handling, enabling CSS and XPath locators to correctly identify and interact with multi-nested Shadow DOM elements.
• [Web UI Self-healing]
  • Fixed an issue where Web Self-Healing actions were triggered but not displayed in the Log Viewer.
  • Fixed an issue where Self-healing did not activate when running on Mobile browser.
• [Execution]
  • Fixed an issue where the Click here to fix broken Test Object option was not triggered in Log Viewer when using Time Capsule.
• [Web Recorder & Spy]
  • Fixed an issue where Spy or Recorder stopped working after being inactive for five minutes when using Firefox.
  • Fixed an issue where Spy Plus and Recorder Plus could not capture test objects after switching between Chrome and Edge Chromium.
• [Mobile Testing] Fixed an issue where the locator strategy in Mobile Object Spy’s message appeared in the wrong order.
• [StudioAssist]
  • Fixed an issue preventing StudioAssist settings from being saved after clearing the AI API key or clicking Restore Defaults.
  • Fixed an issue where StudioAssist did not include attachments when using Agent mode with Katalon AI Service.
  • Fixed an issue where StudioAssist did not include attachments when retrying in Ask mode.

Known limitations

• [StudioAssist | AWS Bedrock]
  • When using StudioAssist Agent mode with AWS Bedrock and a manually added external MCP Server, make sure every enabled tool has a description. Tools without descriptions can prevent StudioAssist from generating responses.
  • We currently don't support proxy connections for AWS Bedrock.

Version 10.3.2

Release date: September 30, 2025

Katalon Studio 10.3.2 introduces Agent mode in StudioAssist with support for Model Context Protocol (MCP) servers, bringing a new level of AI-powered productivity. This release also includes major UX improvements in the StudioAssist chat window, and a series of stability and bug fixes across wait logic, Log Console, and the Onboarding Tour.

New Features

• [StudioAssist]
  • Introduced Agent mode, a real-time AI collaborator in StudioAssist. Agent mode interprets natural-language prompts, breaks them into multi-step actions, and keeps iterating until tasks are complete. With Agent mode, you can:
    • Automate test case creation and editing.
    • Generate better code and troubleshooting steps, with knowledge leveraged from Katalon Docs site.
    • Connect to external HTTP-based MCP servers (no authentication supported yet).
    • Learn more in StudioAssist Agent mode.
  • Added 2 Katalon MCP servers by default, an open standard that allows AI to connect with tools and project data:
    • Katalon MCP server – ensures answers are accurate and always aligned with the latest documentation.
    • Katalon Studio MCP server – lets AI create/edit test cases and access project context.
    • Learn more in Understanding MCP Servers.

Enhancements

• Added compatibility with Chrome 140, Edge 140, and Firefox 143.
• Updated WebDriverManager from 6.2.0 to 6.3.2.
• [StudioAssist] Improved StudioAssist chat experience with a minimal UI in the chat input section and a retry response option (without thinking).
• [Onboarding]
  • Improved UX when Knowledge Hub and StudioAssist are opened at the same time.
  • Added a Close button to the Knowledge Hub window.
  • Collapsed import statements in Script view during onboarding tour.

Fixes

• [Wait logic]
  • Improved Smart Wait to detect Shadow DOM elements without unnecessary timeouts.
  • Fixed the issue with VerifyElementClickable keyword returning false when element was clickable.
  • Fixed the issue with waitInteractable not waiting for the editable state in the WebUI.setText keyword.
• [Execution]
  • Fixed the issue where the Edge Chromium WebDriver for Edge 140 could not be updated via Tools > Update Web Driver > Edge Chromium.
  • Removed redundant console logs that appeared for ContinueStatement and EmptyExpression during test execution.
  • Fixed log viewer issue where test suite ID was shown as null after execution.
• [Reporting]
  • Fixed duplicated mapping variables when updating from Manual tab.
  • Fixed cases where test suite results were incorrectly marked as Passed despite failures.
  • Fixed the issue where only passed test results were displayed in reports when running with version 10.3.0.
• [Intermittent]
  • Fixed the KRE issue where it could not delete the bin directory, stopping execution with error code 2.
  • Fixed the issue where Log Viewer no longer showed test steps.
  • Fixed intermittent issue where KSE hung after first execution on macOS.
• [Mobile]
  • Fixed excessive Finding web element with id logging when locating web objects on Android devices.
  • Fixed ScrollToText keyword not scrolling to the specified text.
• [Self-Healing]
  • Fixed the issue where Self-healing did not trigger on mobile browsers when test execution reached an invalid or broken Test Object.
  • Fixed the issue where Self-healing did not trigger when the WebUI locator was null or empty.
• [Web Recorder Plus] Fixed Recorder Plus not recording setText for Shadow DOM elements.
• [Onboarding tour]
  • Fixed hidden Scripts tab issue causing Onboarding Tour crashes.
  • Restored Replay button visibility in Getting Started tour when ending the tour halfway.
  • Fixed onboarding UI display issues on Ubuntu.
• [ADO] Fixed missing test suite collection report folder in ADO email attachments.
• Fix the issue that prevents opening test cases/test suites in Test Explorer when tracking events encounter an exception.

Known limitation

• [StudioAssist | Ask & Agent mode] Sometimes, clicking Reload in StudioAssist may cause it to hang. To resolve this, close and reopen the chat.

Version 10.3.1

Release date: August 20, 2025

Katalon Studio version 10.3.1 is a patch release featuring key bug fixes and performance improvements aimed at enhancing stability and overall functionality. This update addresses Smart Wait timeout issues, improves recorder handling for custom date pickers, enhances license management, and resolves several execution-related defects to deliver a smoother, more reliable testing experience.

New Features

• [Mobile Testing] Implemented support for new scroll to text mobile keyword functionality. See Enhanced Scroll To Text.
• [Web Testing] Added new WebUI.jsClick keyword for JavaScript-based click operations. See [WebUI] JavaScript Click.
• Added a re-login button that uses saved login credentials when a forced logout occurs. For details, see the note under Enable Remember Me in Login.
• Implemented a new Remember Me option in login dialog with auto-session refresh and retry logic. See Enable Remember Me in Login.
• [TestCloud] Added the beta or dev version information next to the browser version number in the TestCloud Configuration dialog (in test suite and test suite collection), Report Summary, Execution Environment, and report files (HTML, PDF, CSV, JUnit).

Enhancements

• [Reporting]
  • Added ability to customize TestOps test run names directly from KRE command line.
  • Enhanced TestRail integration with support for mapping multiple TestRail IDs. See Map test cases between Katalon Studio and TestRail.
• [Smart Wait] Resolved timeout override issues when Smart Wait is enabled to ensure correct elapsed time matching.
• [Web Recorder Plus] Improved Recorder Plus to better capture setText actions for web elements with custom date pickers.
• [ADO Integration] Added option to choose whether to override existing automated test name and storage values.
• Added Chrome 139, Edge 139, and Firefox 141 compatibilities.
• Updated all JDBC libraries to the latest supported versions.
• Updated WebDriverManager from version 6.1.0 to 6.2.0.
• Added project trust dialog when opening untrusted KS projects for enhanced security. See Trust dialog on first open.

Fixes

• [Mobile Testing]
  • Corrected incorrect locator capture note URL in Mobile Object Spy.
  • Fixed Cannot hide keyboard issue on iOS devices.
  • Resolved Mobile Tap and Hold hanging indefinitely on incorrect locators.
  • In iOS, keyword uncheckElement did not work in version 10.2.3, although it functioned correctly in the revious version.
  • Fixed ScrollToText keyword throwing StackOverflowError with long list items in Appium.
  • Fixed incorrect timeout handling logic for mobile waitForElementNotPresent keyword.
• [Smart Wait]
  • Fixed client timeout to remote server being limited to 3 minutes in KS 10.x.
  • Stopped sending getTitle requests to remote server after test termination or missing closeBrowser step.
  • Fixed waitForAngularLoad keyword not working properly.
  • Corrected timeout logic for waitForElementNotPresent keyword across all KS versions.
  • Fixed 30-second delay when Spy/Recorder highlights elements with Smart Wait enabled.
  • Fixed Web Element is null error when running projects created from KS 10.2.4 or earlier versions.
  • Fixed Smart Wait functionality to work properly on Remote and TestCloud execution environments.
• Fixed browser opening issues when webSocketUrl=false desired capabilities are added in Chrome.
• Resolved inability to run tests on Chrome Active Browser due to DevToolsActivePort errors.
• Fixed ScrollToElement using JavaScript, which causes incorrect website display when scrolling.
• Fixed proxy settings being deleted when opening two (2) KS instances on one machine.
• Fixed NullPointerException when response size is too large.
• Resolved intermittent unable to resolve class katalon.pages.platform.common.Filter exception when executing a test suite.
• [File Path and System issues]
  • Added proper file and folder path length validation on Windows systems.
  • Fixed inability to open KS in Windows Server 2016 from KS 10.2.3 due to SWT DLL errors.
  • Resolved Java update errors during execution.
• [TestCloud] In remote execution:
  • Fixed test cases incorrectly showing SKIPPED status when running from TestCloud only.
  • Resolved missing test suite collection report folder in email attachments for ADO integration.
  • Fixed missing Execution by information in HTML reports when executing with TestCloud.
• [Onboarding]
  • Enhanced error message triggered when the Onboarding Tour crashed since Recorder Plus was using an active browser.
  • Fixed default URL being changed when starting Onboarding Tour after recording other pages.
• [Reporting]
  • Fixed incorrect browser information display in email reports when running with TestCloud.
  • Resolved WEBM video generation issues on macOS/Linux with Chrome.
  • Fixed directory validation issues when generating browser-based recordings.
  • Fixed showReferences functionality after renaming parent object folders containing dots.
• Fixed KS not importing all values from Postman requests.
• Fixed errors when adding .jar files to Katalon Studio.
• Resolved KSE crashes when adding custom keywords in test cases.
• Resolved insecure deserialization vulnerability when opening malicious projects with entityReference.index.

Changes

• Windows Desktop App testing now requires a Trial or Enterprise license.

Version 10.3.0

Release date: July 30, 2025

Katalon Studio 10.3.0 delivers substantial upgrades across core testing features, including improved web execution and performance, support for mobile test self-healing, and expanded StudioAssist AI capabilities.

This release also introduces the beta version of desktop application testing—now available without requiring WinAppDriver—along with a redesigned onboarding experience to help users get started more efficiently. Additionally, users can benefit from a refreshed email report template UI, enhanced Recorder Plus features, and a new ability to save API response bodies directly from the Response tab.

New Features

• [API Testing]

  • Introduced a new option to save API response bodies as files. Includes a Save Response Body as File link in the Response tab. See RESTful endpoint in object repository.
  • Response headers now appear in table format for better readability, and large response bodies are displayed more clearly.
  

• [Mobile Testing]

  • Added support for Self-Healing in Mobile Testing to improve resilience for mobile test scripts. See Configure Self-Healing Tests for Mobile.
  • Added support image-based locator capture for Mobile Recorder and Spy, allowing fallback recognition via reference images.
  

• Revamped the Onboarding Experience and added a Knowledge Hub to simplify how users get started, see more in Knowledge Hub:

  • The old onboarding tours from the Start Page, Walkthrough tab, and Tutorial section have been removed.
  • A new basic onboarding tour, focused on the Web Recorder, is now available.
  • The updated Knowledge Hub offers quick access to documentation, tutorials, community, and support resources to help new users onboard with Studio faster.
  

Enhancements

• Introduced the ability to automatically update Azure DevOps (ADO) Test Cases upon test execution by setting the Automation status to Automated and adding the executed test case name in the Associated Automation section. This eliminates manual updates and improves visibility of automated test coverage in ADO. See Enable Azure DevOps Integration in Katalon Studio.

• [Reporting]

  • Introduced a new test suite and test suite collection email report template with a modern UI look and more data displayed. See Customize email template for test suite.
  • Supports the ability to preview test suite and test suite collection email body reports while editing templates.
  • Added profile information to HTML reports for test suites and test suite collections, as well as to email reports.
  • Added the ability to use an external advanced template for email report.
  • Slightly improved the Log Viewer UI with a new implementation using WebView.
  • Introduced new mechanism to display only fail, error, and incomplete test cases in the Test Case table of the email report, and added support for including a test suite summary table in the Test Suite Collection (TSC) email report template.

• [StudioAssist]

  • Now supports Google Gemini integration using both personal keys and a shared organization key set by an admin, and fully compatible with the gemini-2.5-flash model. See StudioAssist Preferences.

  • Now supports for OpenAI-compatible providers using both personal keys and a shared organization key set by an admin.

  • Added an option to use custom keywords as project context for StudioAssist. This will help you reuse existing custom keywords for code generation and get more accurate AI suggestions.

  • When generating or explaining code via script editor, StudioAssist now also uses custom keywords, object IDs, and all content of current uploaded file as additional context.

  • Added a new setting to enable or disable follow-up question suggestions in StudioAssist responses, which now automatically suggest related follow-up queries.

  • Improved UI and error messages for chat interface and error handling.

    
    
    

  • Continued improvements to StudioAssist prompts to enhance guidance and response relevance.

    

• Improved the way we generate the test object naming for better readability in Katalon Recorder.

• Introduced a new setting in Web Recorder Plus that allows user to configure ignoring pattern when generating locator. See Configure exclusion patterns from locator generation.

  

• Improved text verification for Flutter semantic-node elements without innerText, enabling keyword verifyText to accurately detect and validate text values when testing Flutter apps.

• Improved Recorder Plus mechanism to capture shadow DOM elements in Flutter-based web app.

• Re-enabled Windows Desktop Testing (Beta) for basic test cases with the following improvements:

  • Added new Windows keywords takeScreenshot and takeElementScreenshot using FlaUI.
  • Added support to keywords StartApplication and CloseApplication with FlaUI webdriver.

• Improved Smart Wait to Reduce Test Flakiness and Improve Execution Speed. See Smart Wait function.

• Free users can now continue using Katalon Studio Enterprise package after Trial plan ends (with limited feature access).

• Added Chrome 138, Edge 138, and Firefox 140 compatibilities.

• [Console Mode] Added the following UI/UX improvements:

  • Add a scroll bar to Generate Command dialog.
  • Now auto-generates License Server URL when detected that the user logs in with an On-Premise license.

• [WebUI Self-Healing] Automatically excludes Verify and Wait keyword types from Self-healing attempts by default, reducing unnecessary fallback behavior for non-critical validations and improving execution clarity.

• [WebUI] Enhanced screenshot capture accuracy for Take Screenshot keywords by leveraging Chrome BiDi protocol and Selenium 4 improvements, resulting in more consistent and visually accurate screenshots during test execution.

Fixes

• [Web Recorder and Spy]

  • Resolved an issue where captured hover actions failed when involving multiple nested hover levels.
  • Fixed a problem where Spy Plus captured only one object when two different object types were present.
  • Addressed an issue where switching to a different website during recording or spying caused Spy to stop functioning.
  • Prevented redundant Mouse Over action triggered after clicking an object followed by a Tab key sequence.
  • Eliminated duplicate Mouse Hover actions caused by tab switching during recording.
  • Fixed error occurring after installing the Katalon Studio Recording Engine (KRE) plugin.
  • Corrected failure to start recording with an active browser after changing the application port setting.
  • Improved object recognition when multiple elements have nearly identical attributes — Spy now captures all distinct objects.
  • Fixed an issue where using Attribute as a selector prevented Recorder and Spy Plus from highlighting or finding objects.
  • Resolved invalid locator errors when using the @text attribute in locators.
  • Improved fallback suggestions in Self-Healing for Recorder Plus locators.
  • Fixed Recorder Plus failures when executing test cases during an active recording session.
  • Resolved inability to capture object images while using Active Browser mode.
  • Addressed highlight issues on tables, dropdown lists, and combobox controls.
  • Restored support for keyword WebUI.SelectOptionByValue, which was missing in versions 8.6.5 and 8.6.6 in Web Recorder.
  • Fixed Spy Plus issues where navigating to another website during a session would cause Spy to stop working.
  • Addressed a dependency regression that caused automation to accept beforeunload prompts unexpectedly.

• [StudioAssist]

  • Updated StudioAssist to properly display a No internet connection message instead of raw error text.
  • Fixed a MacOS-only issue where the copy function in StudioAssist Chat did not work unless the chatbot was focused.
  • Resolved intermittent issues where requests with the current file and attachments failed to send.
  • Fixed an error that caused StudioAssist to stop working when switching between Keyword and Debug modes.
  • Updated prompt behavior to avoid generating scripts with unsupported Groovy versions.

• [Smart Wait & Performance]

  • Resolved a bug where Smart Wait triggered unnecessarily on every action involving Angular 14 test objects.
  • Addressed a conflict where Smart Wait caused navigation steps to exceed two minutes.
  • Fixed excessive Smart Wait calls during execution with local Appium and Android devices.
  • Resolved an issue where Katalon Studio froze when uploading test reports with test suite-level data binding.

• [Reports]

  • Fixed email subject not recognizing ${totalFailed} and ${totalPassed} variables in test suite and test suite collection.
  • Addressed inconsistencies between test results and test reports for BDD test cases.
  • Resolved WARNING: The isStretchWithOverflow attribute is deprecated. Use the textAdjust attribute instead. error when generating PDF report on 10.2.1 only.
  • Fixed an issue where mobile native app test results were not updated in Azure DevOps when using KSE 10.x.
  • Fixed an issue in the Katalon Jenkins Plugin where stopping a job failed to terminate related processes, causing device conflicts and overlapping test sessions.

• [System and Browser issues]

  • Confirmed save <className>.java dialog appears when saving java class in Include/scripts/groovy folder.
  • Fixed error firefoxAddonSocket is null when switching Spy from another browser to Firefox.
  • Addressed a Z-index layering issue on Linux where StudioAssist text overlapped the Start Page.
  • Resolved incorrect URL navigation when recording in KCU 2.2.2 with an already open browser.
  • Prevented the Test Suite Collection window from auto-switching to the Results tab when toggling between windows.
  • Migrated legacy HTTP clients to ApacheHttpClient to centralize proxy setup flows.
  • Removed unnecessary setN() method calls from OpenAI integrations.

• In mobile test execution, corrected unclear messages when using the selectListItemByIndex keyword for Android.

• Fixed a session termination issue that prevented applications from closing correctly in TestCloud.

• Resolved a failure to execute or record mobile tests on HeadSpin in version 10 (worked in version 9).

• Fixed an issue where verifyElementNotPresent did not trigger self-healing, even when applicable.

• [BDD Testing] Fixed an issue where custom keywords could not be executed in BDD tests unless they were placed in the default package.

• [Mobile Testing] Resolved an issue that prevented Katalon Studio from launching existing applications on a device from a Chinese smartphone manufacturer.

• Since 10.3.0, we have re-adjusted the methods name in MobileTestObject. Deprecated methods have been replaced as follows:

  Deprecated API	Replaced with
  public String getMobileLocator()	public String getLocator()
  public void setMobileLocator(String mobileLocator)	public void setLocator(String locator)
  public MobileLocatorStrategy getMobileLocatorStrategy()	public LocatorStrategy getLocatorStrategy()
  public void setMobileLocatorStrategy(MobileLocatorStrategy mls)	public void setLocatorStrategy(LocatorStrategy ls)

Known Issues

• Setting the webSocketUrl=false desired capability in Chrome currently prevents the browser from launching. To resolve this issue, replace configuration\resources\extensions\Smar Wait.zip with this Smart Wait file.
• Recorded or existing test scripts created in earlier versions of Katalon Studio may fail when executed in version 10.3.0, resulting in the following error: Caused by: java.lang.NullPointerException: Cannot invoke org.openqa.selenium.WebElement.clear() because webElement is null. As a workaround, go to Project Settings > Execution > WebUI > select Apply and Close and rerun the test.

Version 10.2.4

Release date: July 11, 2025

This release focuses on important authentication fixes when using On-Premises version 2.1.8, and updates embedded WebDrivers to support the latest supported browser versions.

Enhancement

• Added Chrome 138, Edge 138, and Firefox 140 compatibilities.

Fix

• Fixed an issue in Katalon Studio Enterprise 10.2.3 where TestOps authentication override failed on On-Premises environments due to incorrect server configuration, now fully tested and resolved for KSE and KRE.

Version 10.2.3

Release date: June 30, 2025

This release introduces customizable StudioAssist settings, major performance and UI enhancements, extended browser and platform support, and a wide range of bug fixes across StudioAssist, Web, Mobile, Reporting, and Platform integration features.

New Features

• [StudioAssist] Introduced StudioAssist settings to customize engineering prompts for a more tailored AI-assisted experience.

Enhancements

• [StudioAssist]
  • Upgraded AI backend to GPT-4.1 mini.
  • Optimized prompts for code generation and explanation, particularly for handling personal keys.
• [Mobile Testing] Support mobile object attributes editing:
  • Added a Generate button to Mobile Object editor.
  • Enabled editing of mobile object property values.
• Supports TestRail with custom required fields.
• Improved logging for report uploads across qTest, Azure, TestOps.
• Enabled gzip encoding for Selenium (Appium) clients to optimize network performance.
• WebUI.authenticate keyword is now supported on TestCloud, remote, and localhost test runs.
• [Reporting]
  • Adjusted Test Suite Collection (TSC) status display in HTML reports.
  • Improved logging during PDF report generation.
• Updated WebDriverManager from 6.0.0 to 6.1.0.
• Added Chrome 137, Edge 137, and Firefox 139 compatibilities.
• [UX/UI]
  • Refreshed UI and icons in the About Katalon Studio dialog.
  • Prevented TestOps connection when apiKey is missing in CLI.
  • Release update check now respects Admin-level control.
  • Added capability to capture raw screenshots on test execution failures.
• Resolved hanging issues in:
  • Creating or modifying test objects.
  • Saving test cases and keywords.
  • Renaming test cases and test objects.

Fixes

• [Web Testing]
  • Fixed screenshots not being captured on errors (FailureHandling=Optional)
  • Resolved malfunctioning WebUI.authenticate() keyword.
  • When using selectOptionByValue, after selecting success, Katalon Studio Enterprise checked its state and always failed.
  • Browser-based recording caused incomplete execution and reporting.
  • Chrome 137 compatibility issues with sample projects.
  • WebUI.takeScreenshotAsCheckpoint keyword failed when executed via Sauce Labs.
  • Fixed issue where web testing on Android failed due to error Original error: invalid argument: cannot parse capability: goog:chromeOptions.
• [Mobile Testing]
  • Mobile.getDeviceOS() keyword returns null when run with TestCloud, HeadSpin devices and all Cloud/Remote platforms.
  • In iOS, Hide Keyboard action failed in Mobile Recorder.
  • Cannot record/spy mobile using application ID.
  • In iOS, Tap and Hold keyword does not work, it just taps but does not hold at specific time.
  • Capture Screenshots on errors instead of warning (FailureHandling=Optional).
  • Saving selected objects unintentionally saved all captured objects.
• The Test Suite Collection window switches to result tab automatically when going to and from another window.
• [Reporting]
  • Secure Storage - Cucumber Reports failed to mask protected values.
  • JUnit test suite report used incorrect timestamp formats.
  • HTML reports had inconsistent execution statuses.
  • Test Suite Collection HTML report loses key info when in expanded view.
  • Test Suite statuses were inconsistent in the Test Suite Collection HTML report.
  • There are missing test step description in new HTML report.
  • On occasion, when a test case fails, status is displayed as Failed instead of Warning.
  • Trimmed unwanted spaces in AI config fields.
  • Explain code was wrong when explaining a regular expression in the sample.
• [TestOps]
  • Katalon Studio Enterprise not reporting result quota exceeded.
  • Resolved the issue preventing automatic report uploads in OP TestOps Agent environments.
• Onboarding Tour shown empty Warning dialog when going through API Tour.
• Authentication is not supported for SOCKS proxy, KSE could not go through SOCKS proxy when configured with Authentication.
• On occasion, the WebDriver instance doesn't have a session ID.
• Katalon Studio Enterprise not reporting result quota exceeded.
• Katalon Runtime Engine occasionally throws ArrayIndexOutOfBoundsException error in console log when running a test suite collection.
• Fixed error exception when using katalon-studio-ctrf-report-plugin plugin.
• Unable to run Katalon Runtime Engine with only TestCloud license.
• Using wrong orgId when fetching TestOps integration configuration.
• Test cases failed unexpectedly in version 10.
• Self Healing is not working for Custom Capabilities if the Remote caps is empty.
• Missing suite when scheduling on TestOps due to a crash in ExecutionReportScanner.scanReportFolder.
• In Katalon Runtime Engine, when running on CI/CD with GitHub action, the following error message appears: WARNING: Secure coding is not enabled for restorable state! Enable secure coding by implementing NSApplicationDelegate.applicationSupportsSecureRestorableState: and returning YES.
• Intermittent missing Test Report after running a test suite collection with Katalon Runtime Engine.
• In macOS, occasionally Katalon Studio is not responding when opening the Declaration function.
• Linux Test run is terminated when the running process consumes huge memory.
• Windows Test run disconnects the DevTools/debugging connection when consuming out of memory.
• When executing a test run using CMD, Ctrl+C doesn't terminate the execution.
• The loading screen while starting KS is reversed after upgrading Eclipse.
• In macOS, test case renaming errors occur from second attempt onward.
• When clicking on Configure Specific Project Setting..., it causes a nullpointer exception.

Known limitation

• Browser hang issue occurs when launching Chrome version 135 and above in Katalon Studio. From Chrome 136 onward, security restrictions prevent using the default profile folder. Refer to the following documentation for the workaround: Katalon Compact Utility for Katalon Studio.

Version 10.2.2

Release date: June 18, 2025

Fixes

• Remove Chrome for Testing for recording and execution. Katalon Studio now reverts to using Chrome as usual.
• Added the argument -disable-features=DisableLoadExtensionCommandLineSwitch in Desired Capabilities to address the issues with Chrome 137.

Version 10.2.1

Release date: May 31, 2025

Fix

• Katalon Studio’s Web Recorder failed to launch on Chrome version 137 due to changes in browser automation protocols, including the removal of the --load-extension flag.

  Starting with this version, Katalon Studio uses Selenium Manager instead of Web Driver Manager for Chrome browser, enabling support for Chrome for Testing. During both recording and execution, Katalon automatically downloads the compatible Chrome version the latest version (or specified version) of Chrome for Testing, restoring full functionality with Chrome v137 and later.

  On the first launch, Katalon Studio will download Chrome for Testing, so starting the browser may take longer.

  To change this behavior, launch Chrome with binary desired capability specifying the desired Chrome binary location and add the following args as shown in the screenshot below:

    --disable-features=DisableLoadExtensionCommandLineSwitch
  

  You can also specify a Chrome binary location using the binary capability to control which version of Chrome for Testing is launched.

  note

  For detailed steps on setting up your desired capabilities, see: Set up Desired Capabilities for WebUI Testing in Katalon Studio

Known issue

• In some secured or network-restricted environments, users may be restricted from downloading the WebDriver due to network or firewall policies. To ensure proper functionality, your IT team will need to whitelist the following URLs:
  • https://storage.googleapis.com
  • https://googlechromelabs.github.io/chrome-for-testing/known-good-versions-with-downloads.json

Version 10.2.0

Release date: April 23, 2025

New features

• [StudioAssist]
  • [StudioAssist chat] Added test object IDs as StudioAssist context.
  • [StudioAssist chat] Auto-use content in the focus tab as context.
  • Support file attachments in StudioAssist chat conversation.
  • Added the ability to customize tags that are auto-added to test cases using AI.
  • Added the ability to use StudioAssist with an OpenAI/Azure OpenAI key shared across the Organization. This configuration will be done in TestOps version 3. See Configure a default or organization-specific AI key.
• [Report]
  • Introduced a new test suite HTML report template. View sample test suite report.
  • Added an option to split the HTML report into smaller files to reduce memory consumption and loading time.
  • Added an option to auto-generate the Console logs file in the report folder.
• [ADO Integration] Azure DevOps now allows you to link multiple test cases from multiple test plans. Introduce protected global variables for secure storage. The values of protected global variables are saved outside of the Studio project and masked in logs and reports.
• Added an option to override protected global variables during Katalon Runtime Engine (KRE) runtime.
• Introduced Kerberos support for Proxy Authentication (Beta). See Kerberos proxy authentication (Beta).

Enhancements

• [StudioAssist]
  • Support currently available OpenAI models: GPT-4o, o3-mini, o1.
  • Added a Settings icon and displayed the current AI service in the chat window.
  • Improved StudioAssist message when there is no internet connection.
• [Jira plugin] Allow users to remove linked issues in test cases.
• [Mobile] Add Mobile Keyword "Press Home" in the Mobile Recorder Available Actions.
• [Report]
  • Specify iteration names for Data Driven Testing (DDT) is now supported for PDF and CSV reports.
  • Masked variables are now marked as asterisks in HTML and PDF reports.
  • Test Suite Listener (Before & After Test Suites) is now included in HTML, CSV, and JUnit report files.
  • [UI] Adjust the position of the report project setting page and add an option to go back to the old report template.
  • Updated the SLF4J logging lib provider to resolve issues related to logs.
  • Improved PDF report generation process to better support large test execution.
  • [UI] Auto-refresh data in 3 columns in the Test Case table and Analytics tab in test suite results when integration info changes.
• [Execution]
  • Improved the flow to auto-update webdrivers when running a test suite collection.
  • Automatically save test cases before execution when running a test suite collection.
  • Filter organizations that belong to an account in the select Org step when logging into Katalon Studio.
  • [UI] Added sorting function in the Profile section for Global variables. This applies to Name and Protected columns.
  • Updated WebDriverManager from 5.9.2 to 6.0.0.
  • Upgraded to Selenium 4.28.
  • Added Chrome 135, Edge 135, and Firefox 137 compatibilities.
  • Updated all the latest docs links in the Katalon Studio application.

Security compliance

• Update Katalon Studio updater - commons-io:commons-io to version 2.15.1.
• Refactored dependencies for some Katalon bundles to resolve vulnerabilities.
• Upgraded to org.eclipse.jetty:jetty-http@12.0.18.
• Upgraded to org.eclipse.jetty:jetty-server@12.0.18.
• Upgraded to io.cucumber:datatable-dependencies@1.1.16.

Fixes

• Resolved the issue where Self-healing could not work with custom Desired Capabilities.
• Console | Run test with Debug from here does not log running steps in Console log at runtime.
• Missed all the logs of test steps, and strange logs were generated in the console.
• Script code vanishes when a test case is renamed.
• [StudioAssist]
  • Error User is not authorized to access this resource with an explicit deny appears when the user picks a license from a random org.
  • StudioAssist did not work with OpenAI reasoning models.
  • Unable to answer questions related to automation testing in StudioAssist chat.
• The JUnit report format did not match the standard for reporting skipped tests.
• Sample project failed when executed on Chrome 135.
• [KCU] Unable to run a test with Edge Chromium because of strict policy.
• [TestCloud] No Session Found error when executing test cases in a test suite.
• [Mobile]
  • Using the wrong app ID when the Android and iOS apps have the same name.
  • Locator Strategy set to Android UI View Tag unexpectedly switched to Android UI AUtomator, causing recording issues.

Changes

• When moving a test case in Katalon Studio, relevant artifacts are also moved in the script folder of that test case.
• Upgraded Ubuntu in Docker image from 20.04 to 24.04.
• Use the selected project for TestCloud integration instead of the Organization.
• Upgraded to Eclipse 2024-06.

Known limitations

• When using the option to split the HTML report into small .js files, the data folder containing .js files is not included when sending emails. It means that when you split the HTML report into smaller .js files and send an email report, it only sends the summary HTML report, and the test steps will be missing.
• [StudioAssist|Katalon AI] - Unable to list out all of the objects in a large project.

Version 10.1.1

Release date: March 12, 2025

Enhancements

• Officially supports parameterizing associated Azure DevOps (ADO) Test Case IDs. For more details, see Parameterize Azure DevOps Test Case ID List in Katalon Studio
• We have added a new Execution Profile column in the Azure DevOps Test Configuration Mapping to improve test result accuracy and management. This enhancement provides testers with additional context by displaying the selected Execution Profile alongside the Execution Environment for each test execution, ensuring better traceability and informed decision-making.
• Introduced the ability to add a Jira issue directly to an existing test case, improving issue traceability and test case management.
• Upgraded to JRE version 17.0.14+7 in Katalon Studio (KS) and Katalon Runtime Engine (KRE) for improved security and performance.
• Introduced the ability to switch between the in-app and system browsers for enhanced flexibility:
• Added support for the latest browser versions:
  • Chrome 134
  • Edge 134
  • Firefox 136
  • Gecko 0.36.0
• Upgraded to Node.js 20.1, addressing the Node version 10 is out of life warning when running Azure DevOps pipelines.
• Improved the performance of Log Viewer and Job Progress by updating the Java logging library to fix incorrect log file parsing issues.

Fixes

• No error message was displayed when cloning a Sample Project with a duplicated project name or incorrect drive/location.
• Fixed an issue where importing test cases from Jira failed with the error: An internal error occurred during: "Importing issues.".
• Resolved an issue where Jira integration failed with the error: The current user does not have administrator permission..
• Fixed an issue where Android applications failed to start when using a wildcard to exclude hosts in Windows > Katalon Studio Preferences > Katalon > Proxy > System.
• Resolved a TestCloud license activation failure when executing tests with KRE on GitLab Docker, which resulted in the error:java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING at line 1 column 1 path $..
• Fixed a bug where the Start Page appeared blank after reloading.
• Resolved an issue where the Start Page was broken in offline mode when opening a new project.
• Corrected the release note link in the Start Page offline mode.
• Fixed incorrect behavior when selecting/unselecting checkboxes in Self-Healing Insight.
• Fixed an issue where tests failed to start in Chrome due to SOCK proxy issues.
• Resolved an issue preventing test execution in Edge Chromium v133.0.3065.51 on Windows.
• Fixed an error when parsing test reports containing special Unicode characters, which previously resulted in:javax.xml.stream.XMLStreamException: ParseError at....
• Resolved an issue in which the -g_VARIABLE argument in KSR Docker execution failed to override global variable values.

Changes

• Removed the logic to check the Organization ID when activating Katalon Studio/Katalon Runtime Engine.
• Removed the logic to filter projects by Organization in TestOps integration settings. The list of Projects in TestOps integration is now all Projects that belong to the User in the Account that they selected to log in to Katalon Studio with.
• Removed the TestOps integration dialog that automatically pops up when creating a new project.

Version 10.1.0

Release date: January 21, 2025

New features

Introduced StudioAssist chat window and improved StudioAssist accuracy by upgrading to the GPT 4o-mini model. You can now instantly access and chat with StudioAssist from within your Katalon Studio app. See StudioAssist Ask mode.

Enhancements

• [Email report]:

  • The email summary report now includes the numbers of skipped and incomplete test cases.

  • In Project Settings > Email > Template > Test Suite, you can now add the ${test_case_result_table} variable in the Test Suite's email body template to display a detailed table of test case IDs and their results in an email report.

  • When images are split out of the HTML file, the PNG files option is now auto-selected in Project > Settings > Email for projects created in version 10.1.0 and later.

• [HTML report] Added Attach reference images using linked screenshots (not embedded) to reduce report file size option in Project > Settings > Plugins > Report to split images as reference files instead of embedding them directly into the HTML test suite report. This option helps reduce the file size of a HTML test suite report.

• [Video recording]:

  • Video recordings now use the test case name as the file name instead of sequential numbers.

  • In Project > Settings > Execution, added new video format options, including webM and mp4, for browser-based recorder.

• Added Tap at position on Mobile Recorder Available Action.

• Added a new mobile keyword: [Mobile] Press Keycode.

• Added the Platform value to the Result section in Report history.

• Updated logs and report files to display detailed browser versions instead of rounded versions.

• Added the Data Binding section to JUnit Report.xml and CSV reports.

• Debug mode now generates reports in HTML, PDF, and CSV formats.

• StudioAssist now uses GPT-4o-mini instead of GPT-3.5-turbo to deliver more accurate responses.

• Upgraded JRE to version 17.0.13+11 in Katalon Studio and Katalon Runtime Engine.

• Set the default encoding to UTF-8 for reports generated in the Katalon Runtime Engine. This ensures support for special characters in reports, including when running tests scheduled from TestOps or locally on a VM machine.

• Test reports now display the actual device used when selecting the Any option in TestCloud for mobile browsers and native apps.

• Added the respectSystemAlerts = true configuration to Appium’s settings to capture system alert and permission dialogs during iOS testing.

• Adjusted default video codecs to improve compatibility with common media players. MP4 and MOV now use H.264, while WebM uses VP9 for better compression efficiency.

• Updated .har file names to reflect Web Service (WS) request names instead of sequential numbering.

• [TestOps integration] Added support for parallel asset uploading, retry mechanism, and detailed logging to enhance upload speed and reliability in TestOps integration.

• Embedded WebDrivers have been updated to support the latest browser versions: Chrome 132, and Firefox 134.

• Renamed all 3.0.17-fat.jar​ files to ​3.0.17.jar​ to resolve classpath issues without requiring manual updates.

• [TestCloud] Introduced a setting to switch between legacy and new TestCloud Hub configurations in Project > Settings > Katalon Platform. This option is available when Enable Katalon TestCloud Integration checkbox is ticked, but this feature is not yet accessible to all users.

• Automatically tags AI-generated test cases with GenAI. The icon of test cases tagged only with GenAI changes to purple.

• Updated the CDN links for EdgeDriver downloads.

• [KRE] Added support to enable TestOps integration directly from the CI/CD pipeline.

• You can send test results to Azure DevOps Server 2022 when running tests from KSE.

Fixes

• The Use first row as header option in Data Files did not function correctly when linking test data to a checkpoint.

• [KRE]:

  • Using a global variable in the email report template threw an error: System is unable to email report. Reason: groovy.lang.MissingPropertyException: No such property: G_email for class: Script1.

  • KRE did not generate HTML, PDF, or CSV report files when running tests with offline activation.

• The user profile displayed the wrong name after switching organizations and logging in with another account.

• Dragging and dropping a class from one package to another caused the class to disappear instead of moving it.

• Canceling an action in the Mobile Recorder did not stop the object-capturing process.

• Closing a project did not automatically close the associated README file.

• The Name field was not automatically focused when creating a new project.

• The error Failed to install the WebDriverAgent occurred when importing provisioning profiles from Xcode 16.

• StudioAssist did not work after the token was refreshed. The "Unauthorized" error appeared during attempts to explain or generate code.

• Objects could not be highlighted correctly when using Mobile Object Spy.

• Self-Healing incorrectly marked the test step as passed by recovering a failed object using the Smart Locator, even though the locator contained an empty item, and the object could not be found.

• The TestCloud option in Run dropdown menu of a test case disappeared.

Changes

• Updated the banner for StudioAssist on the Start Page to introduce the new chat window feature.

• Removed the Internet Explorer (IE) option from Web Recorder and Object Spy.

• [UI Changes] Removed the Gitter chat and Survicate feedback options.

• [StudioAssist Preferences] Updated Max token to Max completion token to align with OpenAI's new parameter. Max completion token now limits the number of tokens returned in a response. The default value has been increased from 2000 to 16000 to provide more detailed and comprehensive responses.

Known limitations

• Reloading the Start Page results in a blank page.

• When opening an existing project already integrated with TestCloud, the TestCloud option does not appear in the Run menu. This happens when the logged-in user does not have access to the project ID specified in the TestOps integration.

• [StudioAssist chat window]:

  • StudioAssist doesn't pull information from Katalon documentation. For complex or uncommon queries, you may need to refer to Katalon documentation manually.
  • StudioAssist lacks awareness of test object libraries, variables, or test cases. You should specify details in your question to ensure correct outputs.
  • StudioAssist supports one conversation at a time. Use Clear conversation regularly to prevent context errors. Closing the chat also clears the conversation.
  • Responses may be inaccurate. Verify outputs and rate them as Good or Not Relevant to improve StudioAssist. Your feedback is not used to train the AI model or track your conversations.
  • On Windows, there is no functioning hotkey to open the StudioAssist chat window.

Version 10.0.1

Release date: December 5, 2024

New features

• Introduced Katalon Web Recorder Plus (beta) - a new recording engine in Studio that helps you capture more reliable locators, test on more complex scenarios of shadow DOM/iframe, and support Flutter-based web AUT. To learn more about this beta feature, see Katalon Web Recorder Plus.

  • Recorder Plus is available for Web Recorder and Object Spy with Chrome and Edge Chromium, both on Active Browsers and New Browsers.

Enhancements

• [TestCloud]:

  • You can now run a test case with TestCloud mobile browser and desktop browser environment.

  • Changed the availability of private devices from MEDIUM to HIGH in the TestCloud mobile device list.

  • Added a note (*): This device has limited availability and may take longer to load. in the Mobile Browser tab of the TestCloud Configuration dialog.

  • Added execution session id in the console log when executing with TestCloud Mobile native app.

• Added support for mobile testing with Android 15 official.

• [Web testing]:

  • Added Chrome 131, Edge 131, and Firefox 132 compatibilities.

  • Web Recorder and Object Spy using Firefox browser is now up-to-date as when using Chrome and Edge browser.

  • Officially supported keyword: WebUI.scrollFromViewportOffset. See: [WebUI] Scroll From Viewport Offset.

• Supported JDBC Databricks integration.

Fixes

• The Default value of test case variables were not auto-updated when the file in the reference call was changed.

• [Web Recorder]:

  • Clicking the Stop button during playback in Web Recorder did not terminate the playback process.

  • Error Your browser version or type does not support the BiDirectional WebDriver Protocol which is required for Smart Locator functionality. Please update your browser or switch to a compatible one. when playback captured script in Web Recorder.

  • Playback in the Recorder dialog used both BiDi and internal recorder extensions when starting a new browser, instead of using only one as expected.

  • Unable to record step for select value in the drop-down list of the website https://opensource-demo.orangehrmlive.com/web/index.php/auth/login.

  • Delay Between Actions did not work if SmartWait was disabled.

• Creating a new folder in Test Explorer caused Katalon Studio to freeze.

• [KRE] Unable to override argument values from the command line to the console.properties file.

• Closing and cleaning up a project did not clear the Request History.

• CustomKeywords descriptions were truncated in Manual mode and did not display fully.

• Unable to import certain Postman collections into Katalon Studio.

• Opening a new project after modifying a Test Suite Collection did not push through, even after saving changes via the Save Resource dialog.

• [Mobile]:

  • Adjusting the time for the Mobile.tapAndHold keyword in Mobile Recorder caused the captured Test Object to be removed.

  • The Mobile.doubleTap keyword did not work on Android apps.

  • The long name warning shows twice when captured in the Mobile Recorder.

  • Unable to start mobile recording with app ID input for a remote mobile device.

• Adding a p12 keystore under Project > Settings > Network caused API testing to fail with the error: Could not initialize class org.apache.commons.ssl.KeyMaterial.

• Katalon Studio failed to return to default content after handling an alert, causing subsequent Test Objects to be unrecognized.

• In the Manual tab, adding a new test step did not automatically focus the cursor, requiring users to click on the step before typing.

• [JDBC]:

  • JDBC properties in the Set Connection Properties for JDBC Driver section, under Project > Settings > Database, were not correctly applied when reusing the global database connection.

  • Unable to fetch data from SolidDB using the solidDB JDBC driver, despite successfully establishing a connection.

  • Unable to connect to the database via JDBC when the Secure User and Password option was unchecked.

  • Unable to connect to Databricks using the JDBC driver due to unsupported setAutoCommit functionality in Katalon Studio.

• Unable to get the time value in the Har file.

• Error Unable to create the selected preference page appeared when navigating to Katalon Studio Enterprise > Settings... > Cucumber > Java.

• [BDD testing] Step navigation from a BDD feature file to the corresponding step definition did not work.

• Response size in KB was displayed incorrectly for API calls.

• Error Unable to create the request object occurred when starting step 2 of the API tour on macOS.

• Jira integration sent test results to Xray tests even when result sending was disabled.

• Error TestObject called before the type class is set occurred when restoring a session with an open custom keyword file using the TestObject type.

• The list of devices was reset when reopening the TestCloud Configuration dialog of a test suite collection.

• The Save All button did not save all changes made to a Web Service object after updating an authentication token.

• TestCloud failed to run web test cases on iOS devices.

Changes

• [UI Changes]:

  • Added a new Preferences page to enable or disable experimental features, starting with the Katalon Web Recorder Plus (beta). You can see the new page under Katalon Studio > Settings... > Preferences > Katalon > Beta Features.
  • Added a new static button with a call-to-action to review Katalon Studio on G2.
    

• In Katalon Studio Web Recorder Plus (Beta), attributes like src and href are automatically escaped using CSS.escape() function. This adds backslashes (\) before special characters like slashes (/) and dots (.) to enhance stability and compatibility. Do note that these backslashes will not affect the execution of your test scripts. To learn more about the standard escaping function, refer to the following MDN documentation on CSS.escape(): CSS: escape() static method.

• Testing with Android 15:

  • Horizontal swipes in scripts may fail on Android 15 due to the swipe-back gesture, which triggers a return to the previous screen. To workaround this issue, on your device, navigate to Settings > System > Navigation mode, switch to 3-button navigation, and then switch back to Gesture navigation. If the issue persists, reboot the device.
  • When using the takeElementScreenshot keyword, it occasionally fails with the following error message displayed: com.assertthat.selenium_shutterbug.utils.web.ElementOutsideViewportException: Requested element is outside the viewport, even if the element previously passed.

Known limitations

• [BDD testing] Unable to rename a .feature file after it has been run.

Version 10.0.0

Release date: October 30, 2024

New features

• Upgraded Katalon Studio to Selenium 4.22.

• Upgraded Java Client to version 9.2.3.

• Upgraded Appium server to version 2.11.1.

• Updated drivers' versions:

  • Appium XCUITest Driver for iOS: 7.21.1

  • Appium UiAutomator2 Driver for Android: 3.7.0

• [Smart Wait and Smart Locator]:

  • You can now execute scripts containing Smart Locator without installing an extension.

  • You can now execute scripts using the Smart Wait function without installing an extension.

  • Added support for enabling or disabling BiDi by adding the following desired capability: "webSocketUrl": true/false, as shown in the sample screenshot below.

• Added support for mobile testing with iOS 18 official.

• Added new keywords:

  • WebUI.newTab

  • WebUI.scrollFromViewportOffset (beta)

• Added support for Katalon Runtime Engine Docker image on the ARM64 platform.

Enhancements

• Added the Excludes field to the Proxy setting in the Login dialog.

• [TestCloud]:

  • Added the option to record, spy, and execute with randomly selected high-availability mobile devices.

  • Added the ability to view and execute with private devices on TestCloud.

• Added Chrome 130, Edge 130, and Firefox 131 compatibilities.

• [Security Compliance]:

  • Updated WebDriverManager to version 5.9.2.

  • Addressed multiple high-severity CVEs in dnsjava-2.1.8.jar.

  • Upgraded graphql-java_17.5.0.jar to newer version.

Fixes

• Error when running recorded test steps on Web Recorder for the second time.

• [Email report] Unable to send email reports to recipients configured in the test suite while executing tests with KRE.

• Alert and confirmation dialogs disappeared too quickly for WebUI.acceptAlert to interact.

• [Web Testing]:

  • switchToWindowTitle took too long to execute.

  • Issue with width/height returned when using getViewportHeight & getViewportWidth.

• [Test Cloud]:

  • TestCloud Device list was not reset to the first OS version when switching OS.

  • Medium/low selected device was not retained when reopening the run dialog.

  • -orgID showed different values in the command line and TestCloud log information.

• Enable Katalon Platform Integration automatically enabled after closing the TestOps integration dialog.

• Katalon Studio unable to detect dateutil in scripts.

• [Mobile]:

  • Issues with Mobile.swipe keyword.

  • Mobile.pinchToZoomInAtPosition keyword not working.

  • [Mobile Recorder] Error during Swipe action in Recorder tool when using Appium 2.x.

  • Not able to swipe pop-ups.

  • Tooltip display issues and difficulty clicking See document hyperlink.

  • Error when double-clicking an object in Mobile Recorder.

  • Mobile.dragAndDrop keyword not working on Android Emulator.

• Open notification in iOS partially dragged instead of fully opening.

• [Remote] Recorder/Spy tools unresponsive when starting a remote session without Application Path/ID.

• Incorrect Custom Desired capability for Edge.

• Object data type changes on formatting test file with Ctrl + Shift + F.

• Unable to track dynamic test suite and data binding.

• Previously opened tabs not automatically reopened in Katalon Studio, except Test Cases tabs.

• Multi-threading issues in Katalon Studio version 9.x.

• Import from OpenAPI/Swagger icon on the main menu disabled when navigating to Verification or Validation tab.

• WARNING: The 'isStretchWithOverflow' attribute is deprecated. Use the 'textAdjust' attribute instead. was thrown when generating PDF reports on 9.7.0.

• Added HTTP Header was removed automatically after modifying HTTP Body in a Web Service Request.

• Close and Close & Clean up project options did not work when there was an unsaved Test Suite Collection.

• About dialog showed null in its title.

• Take Screenshot when execution failed option was turned off by default.

• Recorded scripts could not be executed on Katalon Recorder.

• Error faultCode=PARSER_ERROR:....Invalid byte 1 of 1-byte UTF-8 sequence. occurred when running SOAP requests with validation.

• Clicking Explore Analytics in Studio Walkthrough did not initiate any action.

• Installer for Katalon Studio Enterprise and Katalon Studio extracted with duplicate folder names.

• [Git integration] Tracking branch was changed after pulling code from a different branch.

• [API] Missing space between Bearer and token occurred when adding Bearer Authorization Header.

• Only one local plugin was loaded when reloading plugins.

• [Mac] Web Recorder window was minimized when clicking Record button or rerunning the recorded script.

• Use system proxy configuration option did not work on Windows.

• Error occurred when logging into Katalon Studio with proxy set to use .pac file.

• Excludes value required reloading after saving and reopening advanced settings.

• Log parsing errors in HAR file were encountered.

• Plugin did not reload when running Katalon Runtime Engine with TestCloud license only.

• Internal error occurred during Downloading Update...". 'byte[] org.apache.commons.io.IOUtils.byteArray() when downloading version 9.7.2 from 9.6.0.

Changes

• Application names updated:

  • Free Edition: Katalon Studio

  • Enterprise Edition: Katalon Studio Enterprise

  • Apple Silicon Chip: Removed the Arm64 suffix.

• Updated MobileBy to AppiumBy class.

• Adjusted offline license and On-Premises flow where login dialog is triggered.

• Ordered test cases alphabetically in Dynamic Test Suite.

• Any test case referencing SmartWaitWebDriver will encounter a runtime error as the class has been removed.

• Updated WebUI.setViewPortSize to align with WebUI.getViewportWidth and WebUI.getViewportHeight, ensuring consistent viewport size results.

• The licenseServer.properties file has been removed as of version 10.0.0.

• Corrected the behavior of setViewportSize to ensure that the values returned by getViewportWidth and getViewportHeight are consistent with the dimensions set by setViewportSize. Note: When using the --window-size in Desired Capabilities, getViewportWidth and getViewportHeight may return different values because this setting adjusts the window size, not the viewport size.

• Refactored DriverFactory. Moved getChromeDriverPath to ChromeDriverUtil. To use getChromeDriverPath(), add import com.kms.katalon.core.webui.driver.chrome and retrieve the path with:

  String chromeDriverPath = ChromeDriverUtil.getChromeDriverPath() 

• Based on Selenium 4 documentation, test capabilities that are not structured to be W3C compliant may prevent a session from starting. The following list outlines the W3C WebDriver standard capabilities:

  • browserName

  • browserVersion (replaces version)

  • platformName (replaces platform)

  • acceptInsecureCerts

  • pageLoadStrategy

  • proxy

  • timeouts

  • unhandledPromptBehavior

• Any capability not listed above must include a vendor prefix. For example, when running on TestCloud, using app and deviceName in desired capabilities can disrupt the session creation process. The correct format for custom capabilities requires a vendor prefix, such as katalon:option for Katalon.

Known limitations

• Katalon Compact Utility (KCU) is not supported with BiDi due to a Chrome limitation with profile management.

• When using BiDi, a BiDi-CDP Mapper tab opens to start the connection.

• BiDi does not work with Incognito mode in Chrome and Edge Chromium. Attempting to open a session in Incognito mode with BiDi enabled causes the browser session to open briefly and then close automatically. This issue affects: Chrome, Edge Chromium, and Chrome Headless. Workaround:

  • Set webSocketUrl = false in desired capabilities to disable BiDi if Incognito mode is required.

• BiDi does not work with custom profiles in Chrome and Edge Chromium. Attempting to open a session with a custom profile and BiDi enabled causes the session to fail with an initialization error.

• Docker image on linux/arm64 supports Firefox version 129 instead of the latest version 131.

• Removal of AbstractEventListener, EventFiringWebDriver, and WebDriverEventListener in Selenium. Follow Selenium documentation to migrate test scripts that use these classes: Removal of AbstractEventListener + EventFiringWebDriver + WebDriverEventListener.

• Simple dialogs (alert/prompt) handler behavior: The unhandledPromptBehavior capability, which defaults to "dismiss and notify" per W3C standards, dismisses simple dialogs automatically. Workaround:

  • Set unhandledPromptBehavior to ignore so that you can handle dialogs manually.

• Install dependencies: Node installation failed during dependency setup, including manual installation (without Katalon Studio). A warning may appear stating, The post-install step did not complete successfully. Workaround:

  • Run the following commands to resolve the issue:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"{"\n"}brew update
    brew uninstall node
    brew install node