Element reference

Tags

Tags

A tag is a project label you attach to elements for filtering and navigation. Tags live in a project catalog. The tag_relation relation connects a catalog tag to an element.

Relations

Related elementHow it connects
TeamScopes the tag catalog together with the project
ProjectRequired catalog owner
Supported elementReceives a link to an existing catalog tag

What you can tag

ElementWhere tags appear
Test caseDetails chips and listing column
BugDetails chips and listing column
Test runDetails chips and listing column
Test run resultDetails chips and listing column
Test accountDetails chips and listing column
Text documentDetails chips and listing column
AutotestDetails chips and listing column
Object repository pageDetails chips and listing column
Object repository elementDetails chips and listing column

Fields

LabelTechnical nameTypeRequiredValidationDefault
NamenamestringYesUnique per team and project, case-sensitive, max 50 characters-
DescriptiondescriptionHTMLNoOptional rich text-
Colortag_color_ididNoColor from the system palette-

Rules

  • Open Tags in a project to create, edit, delete, or clone tags from system templates.
  • Attach existing catalog tags only. Entering a free name on an element does not create a tag.
  • Attaching a tag that is already linked has no effect. Duplicate links are skipped.
  • An element can have no more than 10 tags.
  • Suites, steps, and tags cannot receive tags.

Attach tags on details

  1. Open a supported element.
  2. Expand Tags.
  3. Select Add tags.
  4. Select tags from the project catalog.
  5. Apply the selection.

The selected set replaces the tag selection for that element. Tags appear as chips with a colored left bar.

Add tags to multiple elements

  1. Open a supported element listing.
  2. Select rows with the checkboxes.
  3. Open the context menu.
  4. Select Add Tags.
  5. Select the tags to add.
  6. Apply the selection.

Mass add is additive. Existing tags stay linked, and only missing selected tags are added up to the limit of 10.

Tag details

The tag details page lets you edit the name, description, and color. Tabs group linked elements by type in read-only tables. Use Go to to open a linked element.

In the catalog listing, the name cell includes the color bar. The color is not shown as a separate text column.

Limits

  • The number of tags in a team is capped by the plan. When the limit is reached, a new tag is not created. Live numbers are on the team Total usage tab.

Version 1.3.0 · Last updated 2026-09-15

Did this page help?