Skip to main content

Katalon Help

In case you need some help using Katalon Studio, we have you covered.

From the main toolbar, go to Help. You can see a search bar and a dropdown menu as follows:

In the search bar of the Help menu, type in keywords related to your issue. The results are divided into two categories:

  • Menu Items: Items in Katalon Studio that relate to your search. Hover over each item to display a pop-up containing information on where this item is located.
  • Help Topics: A list of guides selected based on your operating system.

search for help

Studio Walkthrough​

You might see the Studio Walkthrough at the very beginning when you first use Katalon Studio. Katalon Studio supports onboarding tours with tooltips to guide you through each step for:
  • WebUI
  • API
  • BDD

You can always return to the guide to replay the onboarding instructions. After opening your test project, go to Help > Studio Walkthrough.

Katalon Studio prepares a checklist to show you how to:

  • Create your first project
  • Write your first test case
  • Plan your tests with a test suite
  • Analyze your test activities with Cloud Platform
  • Try cross-browser cloud testing
  • Execute test via CI/CD pipeline with Katalon Runtime Engine (KRE)Studio walkthrough page

Start Page​

The Start Page appears by default every time you open Katalon Studio. Alternatively, you can always open this Start Page by navigating to Help > Start Page.

Start Page

In the Start Page, you can see your Katalon Studio edition, version and license expiration date. Under Quick Links, you can navigate to our Plugin Store, Help Center, Documentation, and Academy.

You can also find under Resources section news, advice on testing best practices, hot discussions from our forum, and release highlights.

If you have Katalon Platform integration enabled in your project settings, the Platform section will display an overview of your test execution. You can see the number of executions, the total execution time, test results, and the 3 latest test runs of the test suite.

Report issues from Katalon Studio​

If you click on Help > Report Issues, you are redirected to our Forum, where you can search for or create a new topic related to your problem.

View Error log​

You can view the runtime log of Katalon Studio and Katalon Runtime Engine, which includes any errors that might have.

In Katalon Studio, go to Help > Error Log to open the .log file.

Error log

You can also find the .log file in your local machine at the following locations:

  • For macOS:

    • Katalon Studio: /Applications/Katalon Studio PE.app/Contents/MacOS/config/.metadata/.log
      Tip:

      • .metadata is a hidden folder. To reveal a hidden folder in macOS, click the combination of command + shift + ..

    • Katalon Runtime Engine: /Applications/Katalon Studio Engine.app/Contents/Eclipse/configuration/.log

  • For Windows:

    • Katalon Studio: Katalon_Studio_Windows_64-8.5.0\config\.metadata

    • Katalon Runtime Engine: Katalon_Studio_Engine_Windows_64-8.5.1\configuration

If you run your Katalon project with Jenkins, the runtime log is located at: .jenkins/jobs/<your project name>/builds/<build number>/log.

For example, in macOS: /Users/username/.jenkins/jobs/ci-samples-master/builds/1/log.

Tutorials​

You can view our in-app tutorials for beginners to start testing.

Go to Help > Tutorial to view the tutorial for the following testing types:

  • WebUI
  • Web Service
  • Mobile
  • Desktop

Each tutorial includes step-by-step instructions on creating, executing, and viewing the report for test execution.

Encrypt text​

The encrypted text is helpful when you work with sensitive text. To learn more about encrypted texts, see Working with Sensitive Text.

Check for updates​

You can update to the latest version by navigating to Help > Check for Updates. Updating in this way keeps all your previous configured preferences. To learn more about updating Katalon Studio, see Update Katalon Studio.