> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt
> Use this file to discover all available pages before exploring further.

# raff tag

> Manage account tags from the CLI: list, create, update and delete the tags shared by your servers, with their colour, priority and the firewalls they carry.

<sub>Updated November 10, 2026</sub>

The `raff tag` command group manages the account's tags. A tag is shared by every server that has it, so a rename, colour or priority change shows on all of them. Put a tag on a server with [`raff vm tags add`](https://docs.rafftechnologies.com/reference/cli/vm#tags-add), and link a tag to a firewall with [`raff security-group tags set`](https://docs.rafftechnologies.com/reference/cli/security-group#tags-set).

`create`, `update` and `delete` need the `account.tags.manage` permission (account Owner and Admin by default; it can be added to custom roles).

## Subcommand index

| Subcommand | What it does |
| - | - |
| [`list`](#list) | List the account's tags |
| [`create`](#create) | Create a tag |
| [`update`](#update) | Rename, recolour or reprioritise a tag on every server |
| [`delete`](#delete) | Delete a tag from the account and every server |

***

## list

```bash theme={null}
raff tag list [--output table|json]
```

Lists every tag of the account with its colour, priority, server count and the firewalls it carries (one at most per project). Servers are counted in the projects you can see; set `--project-id` or `RAFF_PROJECT_ID` to count one project.

## create

```bash theme={null}
raff tag create --name <name> [--color <color>] [--priority <1-9>]
```

| Flag | Description |
| - | - |
| `--name` | Required. 1-40 characters, unique in the account ignoring case. |
| `--color` | `gray` (default), `red`, `orange`, `amber`, `green`, `blue`, `violet` or `pink`. |
| `--priority` | 1-9, 1 highest. Leave it out for none. |

## update

```bash theme={null}
raff tag update <tag-id> [--name <name>] [--color <color>] [--priority <0-9>]
```

Change a tag on every server that has it. `--priority 0` removes the priority.

## delete

```bash theme={null}
raff tag delete <tag-id> [--force]
```

Delete a tag. It is removed from every server and every firewall link. Firewalls the tag put on servers stay on those servers. Asks for confirmation unless `--force` is set.

## Related

> [card] [Security group commands](https://docs.rafftechnologies.com/reference/cli/security-group.md)
>
> `raff security-group tags set` to link a tag to a firewall.

> [card] [VM commands](https://docs.rafftechnologies.com/reference/cli/vm.md)
>
> `raff vm tags` to tag a server.

> [card] [Tags and organization](https://docs.rafftechnologies.com/products/build/virtual-machines/concepts/tags-and-organization.md)
>
> How tags, colours and priorities work.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.