I pres sit, it says the screenshot was taken, but I can’t find it anywhere.
What is supposed to happen here? What is the purpose of that button?
2 Likes
Problem Analysis
You’re seeing the message “Screenshot taken!” when you click the Add Screenshot button, but you can’t locate the screenshot file afterward. This is actually expected behavior—the button serves a specific purpose that’s different from saving a standalone screenshot file.
What the “Add Screenshot” Button Actually Does
The Add Screenshot button in Katalon Studio’s Web Recorder and Spy Web utilities is designed for image-based object recognition, not for creating standalone screenshot files. Here’s what happens:
Purpose:
When you click Add Screenshot, Katalon Studio captures an image of the selected web element and associates it with a test object for image-based testing. This screenshot becomes part of your test object’s configuration, not a separate file you can browse to.
Where the Screenshot Goes:
The captured image is automatically stored within your test object in the Object Repository. Specifically:
- Location:
<project_folder>/Screenshots/Targets/(relative path by default) - Purpose: Used for image-based element recognition during test execution
- Visibility: You won’t find it as a standalone file in your file system—it’s embedded in the test object configuration
How to Find It:
- Go to your Object Repository
- Select the test object you captured
- In the Object view, check the Image selection method
- You’ll see the image path displayed (e.g.,
Screenshots/Targets/Page_YourPage/image_name) - The actual image file is stored at that path in your project folder
Key Distinction: Recording vs. Execution Screenshots
It’s important to understand the difference:
| When | What Happens | Where It’s Stored |
|---|---|---|
| During Recording (Add Screenshot button) | Captures image for object recognition | Embedded in test object / Screenshots/Targets/ folder |
| During Test Execution | Automatically captures on failures | <project>/Reports/<execution_date>/ folder |
| Manual Screenshot Keywords | You add [WebUI] Take Screenshot to test steps |
Specified location or Reports folder |
If You Want Standalone Screenshots
If you need to capture and save screenshots as separate files (not for object recognition), use these alternatives:
Option 1: During Test Execution
Add screenshot keywords to your test case:
WebUI.takeScreenshot('C:\\MyScreenshots\\screenshot.png')
WebUI.takeFullPageScreenshot('C:\\MyScreenshots\\fullpage.png')
Option 2: Automatic Failure Screenshots
Katalon automatically captures screenshots when tests fail:
- Location:
<project_folder>/Reports/<execution_date>/ - View in: Test Suite Results tab or exported HTML report
References
“Add Screenshot” in Web Recorder captures element image for Image-based object recognition (stored in Object Repository > Screenshots/Targets/ folder, embedded in TestObject).
Location
- Open Object Repository > select captured object.
- Image tab shows path (e.g.,
Screenshots/Targets/Page_name/image.png). - File:
<project>/Object Repository/Screenshots/Targets/...
Standalone Screenshots
Use WebUI.takeScreenshot() in Test Cases (saves to Reports or custom path). Auto-captures on failures in Reports//Screenshots/.
hi @mae1
i will try to explain it in simple way,
the purpose of the Add Screenshot is to screenshot the current element/selector, so it will capture only the selected element.
for example, i’ve already took screenshot of an element, here is the result
the image file should be on your katalon project folder at Screenshots/Targets/{ObjectName}/{image}.png
this is how it’s look like on my macbook
1 Like
@mae1
Below is the simple explanation and short suggestion to you for your question
The “Add Screenshot” button in Katalon Web Recorder does not save a normal screenshot file for viewing in reports or the project folders. Its main purpose is for image-based object recognition.
When you click Add Screenshot, Katalon captures an image of the selected UI element and attaches it to the Test Object configuration. This allows Katalon to identify the element during execution using image matching.
The captured image is stored inside the project under:
<project_folder>/Screenshots/Targets/.
You can also view it in the Object Repository by opening the corresponding Test Object and checking the Image selection method.
Suggestions:-
If you want a normal screenshot file during execution, you can use WebUI.takeScreenshot(), which saves screenshots in the Reports folder (especially on failures).
1 Like
Description About the Question
In Katalon Studio, the “Add Screenshot” option in the Web Recorder is used to capture an image of the web page at a specific step while recording a test case. This screenshot becomes part of the recorded test steps and helps testers verify what the page looked like during that action.
More Explanation
1. What “Add Screenshot” Means
When you click Add Screenshot during recording, Katalon Studio captures the current screen of the web application and attaches it to the recorded test step. This image is stored as evidence of what happened at that moment.
2. Purpose of “Add Screenshot”
The feature is mainly used for:
-
Visual documentation – Shows the exact UI state at a specific step.
-
Debugging errors – Helps identify where a test failed or what changed on the page.
-
Test reporting – Screenshots appear in reports so testers can review execution results.
-
Verification – Confirms that a button, form, or element appeared correctly.
Where the Screenshot Appears
After recording:
-
The screenshot is attached to the test step in the Test Case.
-
It can be viewed in execution reports generated by Katalon TestOps or the Katalon report viewer.
1 Like