Skip to main content

Test Case Management With Tags


To manage test cases better in Katalon Studio, you can manipulate tag properties by utilizing the existing tag values. With the Test Case Management with Tags plugin, you can view all tags in the project and save time by appending existing tags to test cases.

This document shows you how to append and manage tags, search for test cases with multiple tags, and execute test cases with specific tags in console mode.

Test Case Management with Tags Plugin

To append and manage tags, first install our plugin from the Katalon Store: Test Case Management with Tags.

Then, open Katalon Studio and select Your Account > Reload Plugins. For detailed instructions, see Reload Plugins.

Append and Manage Tags

Add Tags to a test case

You can add tags to a test case when you first create a test case. To learn more about how to create a test case, see Create Test Case.

You can also add tags to a test case using the Properties tab. Do as follows:

  1. Open your desired test case.
  2. Switch to the Properties tab. In this tab, you can find more details on a test case, including associated tags.

  3. Input your tag values, separate them by commas or semi-colons.

    To remove a tag, delete it from the tag field.

    properties tab

Append Tags

You can view all tags in your project and append tags to a test case. After installing the Test Case Management with Tags plugin, follow these instructions:

  1. Open a test case and switch to the Properties tab.

    Under the Tag field, you can find the Append tags button.

  2. Click on the Append button. The Append Tags dialog appears with a list of all tags in your project.

  3. Search for and select tags you wish to add to the current test case.


    Tags previously added to this test case already display as selected, and cannot be deselected.

  4. Click Append when you are done. New tags are now added to your test case.

    append tags dialog

Search For Test Cases With Multiple Tags

After you successfully install the Test Case Management With Tags plugin, in a Dynamic Querying Test Suite, you can search for test cases with multiple tags using the Query Provider.

To search for test artifacts labeled with multiple tags, do as follows:

  1. Open a dynamic test suite. See also: Dynamic Test Suite (Dynamic Test Cases List).
  2. Directly type in the Query box following this syntax: tag=(NameOfTag1,NameOfTag2). For example: tag=(may,december).

    query box

Execute Test Cases With Specific Tags in Console Mode

  • An active Katalon Runtime Engine license
  • The Test Case Management with Tags plugin installed

In console mode, you can filter and execute test cases attached with certain tags.

In your command, add this argument:



Learn more about how to run tests in console mode with Katalon Runtime Engine at Command Syntax (Command-line/Console Mode Execution).

When you execute a test in the terminal, you can see the process where test cases are filtered before executing. For example:

TC1 Verify Successful Login is associated with these tags: jan,apr TC2 Verify Successful Appointment is associated with these tags: jan,feb,mar TC3_Visual Testing Example is associated with these tags: jan,feb

In the command, you add this argument: testCaseTags="jan,feb".

The execution log should look like this:

----------------- TEST CASE TAGS PLUGIN START FILTERING -----------------
Test Cases/Main Test Cases/TC1_Verify Successful Login is filtered out
Test Cases/Main Test Cases/TC2_Verify Successful Appointment is a test case to be run
Test Cases/Main Test Cases/TC3_Visual Testing Example is a test case to be run
----------------- TEST CASE TAGS PLUGIN FINISH FILTERING -----------------