---
title: "Using Tags"
description: "Organize and filter monitors with color-coded tags across all monitor types."
---

Tags let you label any monitor, website, DNS, ICMP, SMTP, SSH, FTP, or IMAP/POP, with one or more color-coded badges. You can then filter every monitor list by tag and instantly see which monitors belong to a group (e.g. "Production", "Client A", "Staging").

## Creating Tags

Open **Settings → Tags** and click **New Tag**. Provide:

- **Name**: a short label, up to 50 characters.
- **Color**: choose from the fixed palette: `slate`, `red`, `amber`, `green`, `teal`, `blue`, `indigo`, `violet`, `pink`, or `gray`.

Tags are organization-scoped: every member with sufficient permissions can see and use them.

### Readonly member rule

Readonly members **can** create tags, but those tags are visible only to themselves. A readonly member cannot see, update, or delete tags created by other users. They can assign their own tags to any monitor they have read access to.

## Color Palette

| Key | Color |
|-----|-------|
| `slate` | Slate / neutral gray |
| `red` | Red |
| `amber` | Amber / orange |
| `green` | Green |
| `teal` | Teal |
| `blue` | Blue |
| `indigo` | Indigo |
| `violet` | Violet / purple |
| `pink` | Pink |
| `gray` | Gray |

## Assigning Tags

Tags can be assigned in two places:

### From the monitor list (inline)

In any monitor list (Websites, DNS, ICMP, etc.) find the **Tags** column. Click the tag chip area on a row to open the tag picker and toggle tags on or off for that monitor.

### From the monitor detail page

Open a monitor's detail page and locate the **Tags** section. Use the tag picker to add or remove tags. Changes are saved immediately.

## The Tags Column

The Tags column is visible by default in every monitor list. To get a more compact view, toggle the column off using the **Columns** menu at the top of the list. Your preference is saved per list.

## Filtering by Tag

At the top of any monitor list, open the **Filter** menu and select one or more tags. The list narrows to show only monitors that carry **all** of the selected tags (AND logic). To clear the filter, deselect all tags or click **Reset filters**.

## Managing Tags

Go to **Settings → Tags** to see the full tag list. From there you can:

- **Edit** a tag's name or color (owner or admin only).
- **Delete** a tag: this removes the tag from every monitor it was assigned to (cascade delete).

## API Reference

See the [Tags API](../api/tags) for programmatic access to create, update, delete, and assign tags.