| description | Organize and categorize test cases with organization-scoped labels. |
|---|
Test labels are organization-scoped tags you can apply to individual test cases to organize, filter, and categorize your test suite. Labels are applied manually today; see Automatic labeling from monitors for what's coming.
Labels are created, edited, and deleted at Settings > Organization > Test Labels. Each label has a name, an optional description, and a color used for its chip in the UI. The settings page also shows how many test cases each label is currently applied to.
{% hint style="warning" %} Deleting a label removes it from every test case it's applied to; this cannot be undone. {% endhint %}
You apply and remove labels from a test case using the label picker on the test case detail page. The picker lets you search existing labels, toggle them on or off, and create a new label inline if one doesn't already exist. Each assignment records who applied the label and when.
On the tests list, you can filter the table down to test cases that have a particular label applied. This makes labels useful for slicing the view by the categories your team cares about.
{% hint style="info" %} Coming soon. Monitors will be able to automatically apply and remove labels on test cases based on test behavior. More details will be published when this is available. {% endhint %}
- Managing detected flaky tests — a step-by-step process for handling detected flaky tests
- Flake Detection — monitors that classify tests as flaky or broken