---
title: "Tags"
description: "Apply tags when a node registers, change a node's tags from the CLI, and convert a node between personal ownership and tags in either direction."
---

Slopscale supports Tailscale tags. Read [Tailscale's tag documentation](https://tailscale.com/docs/features/tags)
to learn how tags work and how to use them.

Tags can be applied during [node registration](/slopscale/ref/registration):

- using the `--advertise-tags` flag, see [web authentication for tagged devices](/slopscale/ref/registration#web-authentication)
- using a tagged pre authenticated key, see [how to create and use it](/slopscale/ref/registration#pre-authenticated-key)

Administrators can manage tags with:

- Slopscale CLI
- [Slopscale API](/slopscale/ref/api)

## Common operations

### Manage tags for a node

Run `slopscale nodes list` to list the tags for a node.

Use the `slopscale nodes tag` command to modify the tags for a node. At least one tag is required and multiple tags can
be provided as comma separated list. The following command sets the tags `tag:server` and `tag:prod` on node with ID 1:

```console
slopscale nodes tag -i 1 -t tag:server,tag:prod
```

### Convert from personal to tagged node

Use the `slopscale nodes tag` command to convert a personal (user-owned) node to a tagged node:

```console
slopscale nodes tag -i <NODE_ID> -t <TAG>
```

The node is now owned by the special user `tagged-devices` and has the specified tags assigned to it.

### Convert from tagged to personal node

Tagged nodes can return to personal (user-owned) nodes by re-authenticating with:

```console
tailscale up --login-server <YOUR_SLOPSCALE_URL> --advertise-tags= --force-reauth
```

Usually, a browser window with further instructions is opened. This page explains how to complete the registration on
your Slopscale server and it also prints the Auth ID required to approve the node:

```console
slopscale auth register --user <USER> --auth-id <AUTH_ID>
```

All previously assigned tags get removed and the node is now owned by the user specified in the above command.
