---
title: Tags
description: Group, find and bulk-manage monitors with tags, and use them to build status-page components and target maintenance windows.
canonical: https://watchfor.io/docs/monitors/tags
---

# Tags

Group, find and bulk-manage monitors with tags, and use them to build status-page components and target maintenance windows.

As your list of monitors grows, **tags** keep it organized — and they are the
glue between monitors and the rest of WatchFor.

## Tag format

- Up to **10 tags** per monitor, each up to **32 characters**.
- Lowercase letters, digits, hyphens and colons — so both plain labels
  (`production`, `eu`, `api`) and key:value pairs (`env:prod`, `team:payments`,
  `customer:acme`) work. Tags are lowercased automatically.

## Adding tags

- When creating a monitor, or later on its **Settings** tab. Existing tags
  are suggested as you type.
- **In bulk** — select several monitors in the list and choose **Add tags**
  or **Remove tags**. Handy when you onboard a new environment or reorganize.
- On import — CSV rows and the API accept a `tags` array.

## Where tags are used

| Feature | How tags help |
| --- | --- |
| **Monitor list** | The search box matches tags as well as names and targets — type `env:prod` to see just that slice. |
| **[Status pages](/docs/status-pages/components)** | A component can include *every monitor with a tag*. Monitors you add later with that tag join the component automatically. |
| **[Maintenance windows](/docs/monitors/maintenance)** | Target a window by tag; new monitors carrying the tag are covered without editing the window. |
| **API** | `GET /v1/monitors?tag=…` filters by tag — see [List monitors](/docs/api/monitors#list-monitors). |

> **Info**
>
> Structure tags around how you operate — by environment, team, region,
> customer or service — rather than by monitor type; the type is already a
> filter of its own.

## Also via API

`tags` is a field on [create](/docs/api/monitors#create-a-monitor) and
[update](/docs/api/monitors#update-a-monitor) monitor calls, and the list
endpoint filters by tag.

---

Canonical page: https://watchfor.io/docs/monitors/tags · All docs: https://watchfor.io/docs · Site guide: https://watchfor.io/llms.txt