Tags

Tags are colored labels that help you organize and categorize your Flows, Test Cases, and Test Suites. Use tags to group related items and quickly find what you need — for example, smoke, regression, checkout, or flaky.

Tags are project-level and can be reused across different test assets.

Creating tags

You can create tags in two ways:

From project settings

To create a tag:

1. 1
   Open Settings from your project.
2. 2
   Navigate to the Manage Tags tab.
3. 3
   Click Create Tag.
4. 4
   Enter a unique Tag Name.
5. 5
   Choose a Color for the tag.
6. 6
   Save the tag.

The tag will now be available to use across your Flows, Test Cases, and Test Suites.

While editing a test asset

You can also create tags without leaving the current workflow:

1. 1
   Open a Flow, Test Case, or Test Suite.
2. 2
   Go to the Tags field.
3. 3
   Start typing the tag name.
4. 4
   If the tag does not exist, select Create "your text".
5. 5
   Enter a unique Tag Name.
6. 6
   Choose a Color for the tag.
7. 7
   Save your changes.

The new tag will be created and automatically applied.

Applying tags

Tags can be attached to:

• Flows — organize reusable workflows by purpose, feature, or status.
• Test Cases — group tests by scenarios such as smoke tests or regression coverage.
• Test Suites — categorize collections of tests for easier management.

You can apply multiple tags to the same item, allowing flexible organization based on your team's workflow.

Filtering by tag

All list views support filtering by tags, making it easier to find specific groups of tests.

For example:

• Filter by smoke to quickly find tests that should run before a release.
• Filter by regression to identify tests included in regression cycles.
• Filter by flaky to review tests that may need maintenance.

Renaming and deleting tags

Renaming tags

Renaming a tag automatically updates it everywhere it is used. Any Flow, Test Case, or Test Suite using that tag will continue to reference the updated name.

Deleting tags

A tag can only be deleted when it is no longer being used.

Before deleting a tag, remove it from all Flows, Test Cases, and Test Suites where it is applied. If the tag is still in use, TestOwl will prevent deletion and notify you that the tag is attached to existing items.

Next steps