Skip to main content

Specify iteration names in data-driven testing reports

Last updated: November 2026

When a test case is executed with a test data row, it is counted as an iteration. This document shows you how to differentiate iterations in test reports.

Requirements
  • Starting with Katalon Studio 11.7.0, data-driven test execution requires a paid plan. See pricing page.
  • This feature is available for data-driven tests with test suites.

When working with data-driven tests, to quickly identify failed data inputs and parts of the application under test (AUT) that might have a problem, you can add a specific variable from the data file at the end of each iteration name. With this input for iteration name or iteration names, you can differentiate between each iteration in your data-driven testing reports at a glance.

Set iteration names in data binding​

To set iteration names using one of the variables in the test data, do as follows:

  1. Perform data-binding from internal data, Excel, CSV, or database data. To learn more about data binding, see Run Test Case with an external data source.
  2. In the Variable binding section, click on the Select toggle next to Set Test Name.
Set test name
  1. A list of variables appears. Choose an option to add to your iteration name.
Select variable name
  1. Save and run your test.

View data-driven testing reports​

In test cases table​

After running the test suite, open its report under Reports. In the Test Cases table, expand the test case to see each iteration on a separate row. Each row shows the iteration number, the value of the variable selected for Set Test Name, and the elapsed time—for example, Iteration 1 | 'Flying Ninja' (0.059s).

Test Cases table showing four iterations under one test case, each with its selected data value and elapsed time

To learn more about Test Case Table and reports, see Test Suite and Test Suite Collection Reports.

In other reports​

Katalon Studio supports exporting your test suite execution to HTML, CSV, and PDF formats. The iteration names are marked with the data binding value in the following syntax: "Test Case ID" | "Data binding value".

Custom iteration names appear in Studio-generated reports and the Test Case Table. In Katalon True's native Tests tab, results are listed under the base test case name rather than the custom iteration name. To view custom names in True, open the Studio-generated HTML report under Attachments.

info
  • Katalon Studio 11.3.0 and later also include custom iteration names in JUnit reports.
  • This syntax is also supported in Test case result table of email reports. To learn more email reports, see: Share test reports via email.

  • In HTML report:

    HTML test suite report showing custom iteration names for four product rows

  • In CSV report:

    CSV report showing iteration names and their data binding values

  • In PDF report:

    PDF test suite report listing four custom iteration names

To learn how to export reports to other formats, see Export reports to other formats.

Was this page helpful?

Table of Contents