Skip to main content
Version: current

Katalon Help in Katalon Studio

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

Requirements​

  • Katalon Studio version 7.8.0 onwards.

Search for help in Katalon Studio​

From the main toolbar, go to Help. You can see a Search bar and a dropdown menu like this:

help

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

Quickstart Guide​

You might see the Quickstart guide at the very beginning when you first use Katalon Studio. However, you can always return to this start page to replay onboarding instructions. Katalon Studio supports the onboarding tours for:

  • WebUI

  • API

  • BDD (available for Katalon Studio - Standalone Edition version 8.4.0 onwards)

First, go to Help > Quickstart Guide. Then, choose a type of automated test to go to the corresponding onboarding tour.

choose the type of automated testing

Based on the type of automated testing type you choose, Katalon Studio shows you how to:

  • Create and run your first test.
  • Plan your tests with the test suite.Quick Start dialog

Each onboarding tour has tooltip boxes displayed to guide you through the steps. The What's next? section directs you to our documentation page, where you can explore more instructions on how to use Katalon Studio.

From version 8.4.0, Katalon Studio introduces the onboarding tour for behavior-driven development (BDD) testing. This onboarding tour is available for Katalon Studio - Standalone Edition only.

To access the BDD onboarding tour, you need to create or open a Generic Project. Then, choose BDD as the type of automated testing.

choose onboarding tour

Onboarding tour

Start Page​

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

Start Page

In the Start Page, you can see your current Katalon Studio version, edition, and license information, including the expiration date. You can also navigate to our Plugin Store, Help Center, Documentation page (Tutorials), and Academy.

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

How to turn off Start Page content in Katalon Studio​

You can enable and disable the Start Page content in Katalon Studio.

  • Katalon Studio version 8.2.0 onwards.

  • An active Katalon Studio Enterprise license.

  1. Go to Preferences > Katalon.
    show start page content

  2. To turn off the Start Page content, uncheck the option Show Start Page contents.
The best practices, hot discussions from our forum, release highlights, and news are turned off on the Start Page.start page disable

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​

From version 7.8.0 onwards, you can view our in-app tutorials for beginners to start testing.

Go to Help > Tutorial to view the tutorial for each testing type:

  • WebUI
  • Web Service
  • Mobile
  • Desktop

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

Encrypted 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.