> For the complete documentation index, see [llms.txt](https://docs.getscandium.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getscandium.com/test-management/tags.md).

# Tags

When you label tests with tags, you are categorizing them based on certain shared similarities even if they don't necessarily belong in the same folder/suites.

A test case can have multiple tags, you can apply these tags as filter when searching for test cases.

For example, you can add a `Critical` label tag to tests that must run in your pipeline.

### Adding/Removing Test Tags

1. On the Tests listing page, click on the options icon of a test
2. Click on 'Tags' from the popup menu\\

   <figure><img src="/files/FCNcjBFFYlXsYNkqSJgH" alt=""><figcaption><p>Clicks on tags</p></figcaption></figure>
3. From the appearing modal, type in your desired tag/label name, and press Enter on your keyboard. You can also select from the list of existing tags.\\

   <figure><img src="/files/fNURIou1ugkG0I7URyCj" alt=""><figcaption><p>Type in tag name</p></figcaption></figure>
4. Once you have added all your desired tags, click on the 'Save' button.\\

   <figure><img src="/files/JxcnVG9GVRGxeDgO5chX" alt=""><figcaption></figcaption></figure>

### Filter tests by tag

To get test cases based on the tags assigned to them:

1. Go to the test listing page
2. Click on the 'Filters' button\\

   <figure><img src="/files/s9ttJzpLvTVZEK7ztWYY" alt=""><figcaption><p>Click on Filters</p></figcaption></figure>
3. On the Filters modal, click on the 'Filter by Tags' dropdown, then select the tags you want to apply to your filter\
   \\

   <figure><img src="/files/oFDKXEhARF1OIUrIaIOe" alt=""><figcaption><p>Select tags to filter by</p></figcaption></figure>

   Only tests assigned to the selected tags will be displayed, irrespective of the folder they are contained within.
