[TIP] How To Help Us Help You!

[Updated August 2020]


Relax. We get it. We really do. There are some pretty smart and clever people on this forum, but you must realize, they are not magicians or wizards or gods. They cannot see your code, they can’t see your errors and they don’t even know what your AUT is meant to do even though it might seem perfectly obvious to you.

So please relax and follow the advice below, before you start writing your post. The advice below will tell you the exact information we need from you. If you take the time needed to do this properly, it will save your time, as well as ours, and…

Help us to help you.

1. We need to see what you are dealing with

Post a screenshot of the page that is failing in your first request for help.

2. We need to see the underlying HTML of the page

Post the relevant section of HTML in your first request for help.

Example HTML screenshot:

See section 8 below to learn how to do capture the live HTML from your browser.

3. We need to see the Test Case code you are having difficulties with

Post the relevant lines of Text Case code in your first request for help.

Example Test Case code:

4. We need to see ALL errors from the console

If you don’t know how to interpret error messages, please copy-paste them, don’t retype a brief version, paste the WHOLE ERROR MESSAGE.

Usually, there is a Caused by statement something like this:

Example Exception Text:

Notice the error above begins with “Caused by”. This information usually leads to a solution. For example, you could try pasting any key terms in the Katalon forum search bar. Perhaps someone else has had the same issue and the solution to your issue is just a few clicks away.


Sometimes, though rarely, the problem lies within Katalon itself. In those rare cases, the Katalon runtime log can prove very helpful (@ThanhTo). You can access the runtime log via the menu:


 * If your runtime log is huge, please zip it before posting it!

5. Integration issues

If you are having integration issues, (Jenkins et al), please attach any relevant logs. They will help enormously.

6. Tell us what you have tried to fix it

Tell us everything you tried to fix it yourself.

7. Mention ANYTHING that you think might help

There’s no such thing as too much information.

8. Learn to Use DevTools.

Finally, many of the points above rely on YOU understanding how to use the Browser Developer Tools (aka DevTools).


[Learning DevTools] is absolutely must-have knowledge for anyone trying to learn test automation. (@Brandon_Hein)

You can follow THIS GUIDE to help you learn how to use DevTools.

And finally, a piece of writing on Getting Answers, for those of you who are interested.



1 Like

Suggestion; everytime you ask someone for a screenshot send them to this page, eventually everyone will see it?

1 Like

Thanx Russ, +1

1 Like

Voted on this.

Just to add, that every problem description should be precise so that we can asses the problem with ease.



+1 Thank you so much !

1 Like

I’ve had so many chances to link to this topic that you’d almost think the majority of Katalon users work in QA or something…


Well, yeah. The topic is comprehensive :slight_smile:

1 Like

I just wanna add another point.

Often times errors have been encountered and resolved, so I would add an elaboration on @Russ_Thomas’s point 6 :

  • When there’s an error in the console log, try to look for the text Caused by: some reasons and copy and paste that text in the forum’s search bar, try out some solutions and mention them.

Thanks, Thanh! Actually that’s exactly why I visited this topic to add this information. Most of (or maybe all) Katalon exceptions are internal StepFailedException, which does not say much. Please, always share full exception text, it is much more helpful than only first few rows.


@Russ_Thomas as the author of the current please amend it with:

  1. We are here from the comunity side.
    We are doing this for fun and during our free time.
    We are not paid.
    Any issues related to the paid version should be preferable passed to the Katalon staff, this is why you pay some money.

Thank you!