Tutorials are grayed out, Quickstart page is completely blank

What do I have I do to see the Quickstart page, to access the tutorials?

Free Katalon license on macOS 13.3.1

At some point before the OS upgrade from 13.1 to 13.3.1, Katalon Studio suddenly stopped starting: I got to see the splash screen, then the main window, then the “authenticating …” popup. When that went away, the main window refreshed, then closed without any messages. After the upgrade, Katalon Studio starts fine, but now the tutorials in the menu are grayed out, the Quickstart page is completely blank.

Because of the startup problem, I had reinstalled Katalon Studio several times already, before the update.

Are the tutorials and the Quickstart page a paid feature?

To answer your actual question.

No, quick start and tutorials are not a paid feature.

I use a free license and I can access the turorials:

and the quick start:

My actual question is, what do I have I do to see the Quickstart page, to access the tutorials?

If you would be so kind to maybe include a screenshot of what you see when clicking on those options it could help us a little bit.

I have tried these options in both dark and light mode and it works fine.

I did notice however that I must have a project open to access this. You do have a project open right?

And you are trying to access it the through the menu the same way as in my screenshot?

The same happens to me with 8.5.5 and 8.6.0 on Linux (Fedora 37).
I used to see the content there before, not sure when they disapearded, so initially I thought is something isolated to my OS in use:

As for the ‘greyed out’ links, I think the OP reffers to those:


1 Like

Just curious. Are those links still greyed out when you have a project open?

@Oliver_Gramberg there are a bunch of free courses here to help you start with katalon:

1 Like

They became active with a project open, but going on one of them, the Tutorial page is also blank at least for my case …

@vu.tran @ThanhTo

I think we need the help from the dev team but I have no idea who may be the best to look into it.

What technology is used by Katalon to render such pages? It is webkit by chance?

If yes, on my machine I have:

webkit2gtk4.1.x86_64                                 2.40.0-1.fc37

which seems to be the latest stable, released on 2023-03-17 , so it may be one of the cause I see those issues.

if not, please provide relevant info so we can have an ideea where to look, and compare with other OS’es known to work.
(here Katalon team must also provide some details, e.g on what Linux / Mac version was tested)

LE: looks like:

[ibus@ibus-t14 Katalon_Studio_Linux_64-8.6.0]$ find . -name *.so

So, I am guessing, libswt-webkit-gtk is no longer playing nice with the latest webkit2gtk4.1
(Gnome are known to break the ABI’s with any release, even minor but this time the breakages may came from webkit himself)
On mac I have no idea what to check and I don’t have such machine, perhaps @kazurayam can dig.

The only thing I know abot mac is, some apps, e. g. Safari, are using webkit also, so chances are high this received an update also.

I suppose, to fix this, eclipse swt libs has to be updated … again … sigh!

No, I wouldn’t. I am not interested in this issue.

Fair enough.

They become active, and I also get to see the content.

But I can’t think of a good reason why they should not show, and automatically so, on the first startup of a new install. I remember they did before.

In Oct 2022, there was an issue: when you upgrade the macOS to 13.0 Vetura, Katalon Studio crashed.

The reason was that macOS 13.0 had a bug, which affected Katalon Studio (more specifically affected the WebKit, HTML rendering engine, which KS uses to show the Tutorial and QuickStart page).

In order to workaround the macOS’s problem, Katalon team modified Katalon Studio v8.5.3-alpha so that it does not open the Quick Start page and others inside Katalon Studio’s main window.

Later, the macOS was upgraded (13.? I haven’t checked which version) to fix the root cause.

I wonder if Katalon Team has restored their interim code change in Katalon Studio properly.



My team will reproduce this rendering issue and update to you guys soon if any. Thank you!

Hi @Oliver_Gramberg and @bionel,

As @jmeintjesn7 noticed, it’s true that you need to open a project to be able to access Quickstart guide and Tutorial. These are not paid features.

For @bionel case on Linux (Fedora 37), since we only tested on Ubuntu 20.04 (as mentioned in Supported environments for Katalon Studio and Katalon Runtime Engine | Katalon Docs), so some UI might not display as expected.

Hope this answer can help :two_hearts:

@xuan.tran how about …

reported by the OP, from the beginning, for Mac OS also?
Are you trying to say I am stupid and I don’t know anymore how Katalon used to work two months ago?

This is not an excuse.
As I mentioned across few topics, Katalon team should extend the scope of testing, at least for major distributions and the most common DE’s in use (Gnome and KDE as a minimum, others like Cinnamon, LXQt etc are just variations of the above somehow)
And use up-to-date environments.

And worry not, If i am right and the issue is caused by the webkit update, Ubuntu users will be also affected soon, the update is at the door :stuck_out_tongue:

Luckily, I am not an active Katalon user … so I really don’t care if you fix it or not.
I am debugging it for fun.
It’s your call.

Found some time to dig a bit more on this issue.
I can confirm it is related to libwebkit2gtk-4 at least on Linux, but not limited.
Steps I did:

  • Installed Ubuntu 22.04 LTS in a VM (the standard edition with Gnome desktop)
  • Installed KS-8.6.0
    In this combination, Katalon run just fine.
    For the second experiment, I used:
  • Kubuntu 22.04 LTS in another VM (the KDE Plasma flavour of Ubuntu)
  • Same KS

In addition to the Quickstart page being blank, some more features are broken.

The same I noticed on my Fedora install… but let’s ignore that, since it is not ‘supported’ by Katalon.

Using a WebService project, Requests are tottaly unusable, the Authorization, HTTP Header tabs, the Response windows and some more are screwed.
See pic:

Now let’s start some fun.
Digging into what gtk related libs I have installed, first suspect being webkit, on standard Ubuntu I have:

~$ sudo apt list --installed | grep webkit
libwebkit2gtk-4.0-37/jammy-updates,jammy-security,now 2.38.5-0ubuntu0.22.04.1 amd64 [installed,automatic]

but on Kubuntu, only the qt5 wrapper of it:

~$ sudo apt list --installed | grep webkit
libqt5webkit5/jammy,now 5.212.0~alpha4-15ubuntu1 amd64 [installed,automatic]

Looking into what is available (on bot Ubuntu and Kubuntu), found:

~$ sudo apt search libwebkit2gtk-4
Sorting... Done
Full Text Search... Done
libwebkit2gtk-4.0-37/jammy-updates,jammy-security 2.38.5-0ubuntu0.22.04.1 amd64
  Web content engine library for GTK
libwebkit2gtk-4.1-0/jammy-updates,jammy-security 2.38.5-0ubuntu0.22.04.1 amd64
  Web content engine library for GTK

… and some other doc and dev related.

So, to fix it, I installed libwebkit2gtk-4.0-37 on Kubuntu also, which grabs some more deps:

~$ sudo apt install libwebkit2gtk-4.0-37
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  enchant-2 libatomic1 libenchant-2-2 libharfbuzz-icu0 libjavascriptcoregtk-4.0-18 libmanette-0.2-0 xdg-dbus-proxy
Suggested packages:
  libenchant-2-voikko gstreamer1.0-libav gstreamer1.0-plugins-bad gstreamer1.0-alsa
The following NEW packages will be installed:
  enchant-2 libatomic1 libenchant-2-2 libharfbuzz-icu0 libjavascriptcoregtk-4.0-18 libmanette-0.2-0 libwebkit2gtk-4.0-37 xdg-dbus-proxy
0 upgraded, 8 newly installed, 0 to remove and 0 not upgraded.
Need to get 25,9 MB of archives.
After this operation, 91,5 MB of additional disk space will be used.

At this point, Katalon was just fine.
To have more fun, I removed libwebkit2gtk-4.0-37 and installed the newest libwebkit2gtk-4.1-0

Katalon is broken again!!!

Webkit2Gtk4.1 and above breaks Katalon!!!

The good part of it, on Linux those libs looks like can co-exist (I was able to install both versions on Fedora, most probably the same is possible for Ubuntu and some other distributions)
I suggest, Katalon team to update the docs for Katalon Linux and mention this as a mandatory dependency.

I have no ideea if this is possible for MacOS.

You have been warned.
@xuan.tran let me know if this helps.

1 Like

Thanks @bionel for your findings, it’s really helpful for us to improve our product better. We’ll investigate more on this issue and let you know if there’re any updates :blush:

1 Like


The issue of grayed-out “Tutorial” has been fixed in v9.2.0. Can you please help verify it? Thank you!