Skip to content

Clarify How Tags and Labels Work on Suite and Test Levels #527

@TetianaKhomenko

Description

@TetianaKhomenko

We need to update the documentation for Tags to clearly explain how tags behave at both the suite level and the test level.

📄 Related documentation page:
https://docs.testomat.io/advanced/tags-labels/tags and https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields/

Problem

There is a common misunderstanding among users regarding tag behavior.

Typical scenario:

  • A test has a specific tag.
  • The user removes the tag from an individual test and saves changes.
  • However, the tag is still displayed.
  • The reason: the tag is applied at the suite level, so it is inherited by all tests inside the suite.

Users often do not realize that removing a tag from a single test is not enough if the tag is assigned to the parent suite.

Required Documentation Improvements

The documentation should clearly explain:

  1. Tag inheritance logic

    • Tags applied to a suite are automatically inherited by all tests inside that suite.
    • If a tag exists on the suite, removing it from a single test will not remove it completely.
  2. How to properly remove a tag from a single test

    • If a tag is assigned at the suite level and should not apply to one specific test:

      • The tag must be removed from the suite.
      • Then re-applied manually (or via bulk multi-select) to all other tests except the one that should not have it.
  3. Bulk tag management

    • Clarify that users can use multi-select to add tags in bulk instead of editing tests one by one.
    • To do so they need to switch to multiselect tests mode

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions