This sample deals with customized reporting features in Citrus. The sample writes extent Html reports using custom test listeners that report test success and failure in that special way. Also the default Html reporting in Citrus is customized using application properties. Read about this feature in reference guide


Citrus as a framework gives us extension points to add customized test reporting. The framework provides listener and reporting interfaces for that. We want to write custom Html reports using the Extent reporting framework. We simply implement a custom reporting class that generates the Extent reports.

public class ExtentReporter extends AbstractTestListener implements TestReporter {

    private ExtentHtmlReporter extentHtmlReporter;
    private ExtentReports extentReports;

    public void onTestSuccess(TestCase test) {
        ExtentTest extentTest = extentReports.createTest(test.getName());

    public void onTestSkipped(TestCase test) {
        ExtentTest extentTest = extentReports.createTest(test.getName());

    public void onTestFailure(TestCase test, Throwable cause) {
        ExtentTest extentTest = extentReports.createTest(test.getName());;

    public void generateTestResults() {

You can review the complete custom reporter on this sample’s github repository.

We add the new reporter implementation as Spring bean to the application context.

public ExtentReporter extentReporter() {
    return new ExtentReporter();

That completes the reporting extension. Citrus will automatically see the new bean and add it to the list of reporters. The reporter is called when tests pass and fail. As a result the reporter writes Extent styled Html reports to the folder target/citrus-reports/extent-reports.html when Citrus tests are executed.

In addition to that Citrus provides some default Html reporting that is also customizable. We can use application properties to customize the report. Lets add a new application property file to the sample sources in resources/

The file contains some property settings that customize the default Citrus Html reporting.

The tests now write default Html reports to the file target/citrus-reports/citrus-reports.html. Also we use a custom reporting logo that is automatically added to the reporting page header. You can now execute the tests in this sample and review the reports.


You can execute some sample Citrus test cases in this sample in order to write the reports. Open a separate command line terminal and navigate to the sample folder.

Execute all Citrus tests by calling

 mvn integration-test

You should see Citrus performing several tests with lots of debugging output. And of course green tests at the very end of the build and some new reporting files in target/citrus-reports folder.

Of course you can also start the Citrus tests from your favorite IDE. Just start the Citrus test using the TestNG IDE integration in IntelliJ, Eclipse or Netbeans.