top of page
  • Writer's pictureGlib Briia

Enhance Automated Testing with Custom Screenshots with Selenium Shutterbug

Updated: Nov 16, 2023

Overview of Selenium Shutterbug - utility library to create customized screenshots using Selenium WebDriver and Java AWT

Dive into the capabilities of Selenium Shutterbug, a robust utility library crafted for creating custom screenshots in test automation scenarios. Integrating seamlessly with Selenium WebDriver and Java AWT, this tool is pivotal in transforming the reporting aspect of test automation.

In the realm of test automation, the clarity and detail in reporting are paramount. Imagine orchestrating thousands of tests across a variety of devices, operating systems, and browsers. Without precise and descriptive reporting, the effort expended can result in mere consumption of resources without yielding actionable insights.

The power of Selenium Shutterbug lies in its ability to generate self-explanatory custom screenshots. These visual reports simplify the task of pinpointing test failures, enabling prompt and effective actions - be it flagging a defect or rectifying the test script.

Developed with a focus on enhancing the efficiency of testers, Selenium Shutterbug streamlines the process of capturing insightful screenshots. Whether it's for attaching direct evidence in bug reports or providing a snapshot of the system's state at a crucial juncture, this tool is indispensable in modern test automation practices.

Exploring Basic Usage Examples of Selenium Shutterbug

Take screenshot and save to default location (./screenshots/):


Take screenshot and specify location to save to:


Take screenshot and scroll in both directions:

This is particularly useful while testing in Chrome, since it if following W3C definition of screenshot and takes screenshot of the top-level browsing context’s viewport only.
Shutterbug.shootPage(driver, ScrollStrategy.WHOLE_PAGE).save();

Take screenshot of specified WebElement only:

Shutterbug.shootElement(driver, element).save();

Compare screenshot taken with the expected one with specified deviation rate:


Take screenshot and save thumbnail as well (with specified resize ratio):


And many more ..

Illustrating Selenium Shutterbug in Action: A Step-by-Step Example

System.setProperty("", "your path to  chromedriver.exe");
        WebDriver driver = new ChromeDriver();
        WebElement googleLogo = driver.findElement("hplogo"));
        WebElement searchBtn = driver.findElement("sblsbb"));
        WebElement searchBox = driver.findElement(By.className("gsfi"));


                .highlightWithText(googleLogo,, 3, "Monochromed logo",, new Font("SansSerif", Font.BOLD, 20))
                .highlightWithText(searchBox, "Blurred secret words")
                .withTitle("Google home page - " + new Date())

Outcome of Using Selenium Shutterbug: Processed Image and Saving Location

Screenshot result from Selenium Shutterbug displaying a monochrome logo and blurred input field, illustrating detailed test failure analysis
Selenium Shutterbug in Action: Highlighting Test Failures with Monochrome Logo and Blurred Input for Clear Reporting.

Accessing Selenium Shutterbug via Maven Central

Integrate Selenium Shutterbug into your projects with ease using Maven Central. Here's the Maven dependency for quick setup:


Setting Up Selenium Shutterbug with Gradle

For Gradle users, incorporating Selenium Shutterbug is straightforward. Simply add the following line to your Gradle build:

compile 'com.assertthat:selenium-shutterbug:x.x'

Join the Open Source Community of Selenium Shutterbug

Selenium Shutterbug is open source project, proudly developed under MIT license and hosted on Github. We welcome and value contributions from the developer community. Find out how you can contribute and be a part of this innovative project here.

2,842 views0 comments


bottom of page