# \[TIP\] How To Help Us Help You!

**URL:** <https://forum.katalon.com/t/tip-how-to-help-us-help-you/12919>\
**Category:** Announcements\
**Created:** [August 29, 2018, 1:23pm UTC](https://forum.katalon.com/t/tip-how-to-help-us-help-you/12919 "2018-08-29T13:23:45Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Russ\_Thomas](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/russ_thomas/32/11884_2.png) [@Russ\_Thomas](https://forum.katalon.com/u/Russ_Thomas)\
**Post date:** [August 29, 2018, 1:23pm UTC](https://forum.katalon.com/t/tip-how-to-help-us-help-you/12919/1 "2018-08-29T13:23:45Z")

</div>

> **My test is BROKEN! NOTHING WORKS! HELP ME!**

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:**  
  

 ![image](https://europe1.discourse-cdn.com/katalon/original/2X/8/888950ffc209805b01fde365f738f3f3fc63df28.png)  
  **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:**  
   ![image](https://europe1.discourse-cdn.com/katalon/original/2X/6/6019f9c140de33c3a0396417cd152d3d9b7fac98.png)

## 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:**  
  ![image](https://europe1.discourse-cdn.com/katalon/original/2X/2/2c240b98d421762b6576728bb3f114dbb223da4c.png)  
  
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.  
  
   

 ![image](https://europe1.discourse-cdn.com/katalon/original/2X/0/071373d814c10a3f7751e6477d1310bd3178ab8c.png).   
  
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:  
  
    ![image](https://europe1.discourse-cdn.com/katalon/original/2X/a/aedbba97bb64c26078cf0c4269f4f36c95000a10.png)   
  
 \* 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](http://forum.katalon.com/t/how-to-the-browser-developer-tools-f12-devtools/34329)** (aka **[DevTools](http://forum.katalon.com/t/how-to-the-browser-developer-tools-f12-devtools/34329)**).  
  
  

 ![image](https://europe1.discourse-cdn.com/katalon/original/2X/2/29ac3db9e281006729109d6c6850942631ab18a5.png)   
  
_[Learning DevTools] is absolutely must-have knowledge for anyone trying to learn test automation._ (@Brandon_Hein)   
  
You can follow **[THIS GUIDE](http://forum.katalon.com/t/how-to-the-browser-developer-tools-f12-devtools/34329)** to help you learn how to use **[DevTools](http://forum.katalon.com/t/how-to-the-browser-developer-tools-f12-devtools/34329)**.  
 

And finally, a piece of writing on [Getting Answers](https://www.mikeash.com/getting_answers.html), for those of you who are interested.

 

* * *

**[Updated April 3, 2023]** by @albert.vu

In an effort to reduce the number of duplicated questions and poorly-formatted topics on our forum, this topic now includes a **Policy section** at the end, where you are required to click on “I have read, understood, and acknowledged this topic” to signal that you would follow Russ’ guide every time you create a topic.

---

_[View the full topic](https://forum.katalon.com/t/tip-how-to-help-us-help-you/12919)._
