# Work Items Tags Limits

Azure DevOps supports up to 150,000 tag definitions per organization or collection.

Source: https://maester.dev/docs/tests/AZDO.1012

<!-- This file is generated by website/scripts/generate-test-docs.mjs. Do not edit manually. -->

<div class="test-byline"><div class="test-byline-avatars"><a class="test-byline-avatar test-byline-avatar--author" href="/contributors/sebastianclaesson" title="Sebastian Claesson · Original author"><img src="https://github.com/SebastianClaesson.png" alt="Sebastian Claesson" width="28" height="28" loading="lazy" decoding="async" /></a></div><div class="test-byline-meta"><span class="test-byline-text">Contributed by <a href="/contributors/sebastianclaesson">Sebastian Claesson</a></span><a class="test-byline-link" href="/contributors">All contributors →</a></div></div>

<p class="test-part">Part of <a href="/docs/tests/maester">Maester</a> · Azure DevOps · Resource usage and limits · <a href="/docs/tests">All checks</a></p>

```powershell title="Run this check"
Invoke-Maester -TestId AZDO.1012
```

## Overview

Azure DevOps supports up to 150,000 tag definitions per organization or collection.

Rationale: Tags are useful for categorizing and querying work items, but an excessive number of unique tags can degrade performance and make management difficult. Hitting the limit may prevent users from creating new tags and could cause UI slowdowns.

#### Remediation action

Regularly review your tag inventory and delete unused or obsolete tags. Consider standardizing on a controlled vocabulary or using area/iteration paths when appropriate.

**Results:**
Keeping the tag count below the limit ensures responsive work item searches and avoids hitting a hard cap that would block new tags.

#### Related links

* [Learn - Work tracking, process, and project limits](https://learn.microsoft.com/azure/devops/organizations/settings/work/object-limits?view=azure-devops)

## Details

<details>
<summary>Every attribute of this check</summary>

| Field | Value |
| --- | --- |
| Test ID | AZDO.1012 |
| Severity | Info |
| Suite | Maester |
| Product | Azure DevOps |
| Feature | Resource usage and limits |
| Area | Engineering systems |
| Resource type | Tenant |
| MITRE ATT&CK | None |
| PowerShell test | [Test-AzdoResourceUsageWorkItemTag](https://github.com/maester365/maester/blob/main/tests/maester/azure-devops/Test.AZDO.1012.ps1) |
| Services | AzureDevOps |
| Learn more | [https://learn.microsoft.com/azure/devops/organizations/settings/work/object-limits?view=azure-devops](https://learn.microsoft.com/azure/devops/organizations/settings/work/object-limits?view=azure-devops) |

</details>

## Source

- Test: [`tests/maester/azure-devops/Test.AZDO.1012.ps1`](https://github.com/maester365/maester/blob/main/tests/maester/azure-devops/Test.AZDO.1012.ps1)
- Documentation: [`tests/maester/azure-devops/Test.AZDO.1012.md`](https://github.com/maester365/maester/blob/main/tests/maester/azure-devops/Test.AZDO.1012.md)
