# 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<br>

   <figure><img src="https://224585108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNbCT5gfctrLuSLyRsMW%2Fuploads%2FQp4XeYeNCndKWa9njNRd%2Fimage.png?alt=media&#x26;token=f6b2c80c-6d17-43dd-91ff-1326dc07d4f1" 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.<br>

   <figure><img src="https://224585108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNbCT5gfctrLuSLyRsMW%2Fuploads%2FiZmzDkRle7BRftvwW750%2Fimage.png?alt=media&#x26;token=e0c7dc40-e1c5-4e0e-8f2d-6656ab693da3" alt=""><figcaption><p>Type in tag name</p></figcaption></figure>
4. Once you have added all your desired tags, click on the 'Save' button.<br>

   <figure><img src="https://224585108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNbCT5gfctrLuSLyRsMW%2Fuploads%2FyLiblHo9N0Ob7wAO8mcc%2Fimage.png?alt=media&#x26;token=05c1ed59-21d5-42d2-81cc-797f9919d77c" 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<br>

   <figure><img src="https://224585108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNbCT5gfctrLuSLyRsMW%2Fuploads%2FN0XSRUQlw8RSI69Esefn%2Fimage.png?alt=media&#x26;token=6f880253-7c3f-4af9-bc7b-97341c7bbaed" 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\ <br>

   <figure><img src="https://224585108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSNbCT5gfctrLuSLyRsMW%2Fuploads%2FakSNXruzgfTtHynXnmkb%2Fimage.png?alt=media&#x26;token=d085fbe8-5668-4c1e-a431-cf50bef14b27" 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.
