---
title: "tags in devlanes.yaml"
url: https://devlanes.run/docs/reference/config/project/tags/
description: "Reference for the tags key in devlanes.yaml."
---

# tags in devlanes.yaml

A top-level key of [`devlanes.yaml`](/docs/reference/config/project/).

## `tags`

Type: mapping of names to mappings.

Optional color and description per tag. Services list their tags in their own `tags`, and tags group them: `+api` selects every service tagged `api` in profiles and in commands such as `devlanes start +api`. A unit's color comes from the first of its tags with a `color` set here, else the first tag naming a category such as api, web, worker or db, else its preset or name. Tags not listed here work too.

```yaml devlanes
tags:
  api:
    color: cyan
    description: HTTP APIs
```

### `tags.<name>`

Type: mapping.

Settings for one tag used in `services.<name>.tags`. Declaring a tag here is optional: services can use any tag and `+tag` selectors work without it. Declare one to pin its color or describe it.

```yaml devlanes
tags:
  api:
    color: cyan
    description: HTTP APIs
```

### `tags.<name>.color`

Type: string.

Color of services with this tag in the TUI and CLI output. When a service has several tags with a color, the first one in its `tags` list wins. Without one, devlanes infers a color from category words such as `api` (blue), `web` (green) or `worker` (magenta) in the service's tags, preset or name.

Values:

- `red`: Show the tag's services in the terminal's red color.
- `green`: Show the tag's services in the terminal's green color.
- `yellow`: Show the tag's services in the terminal's yellow color.
- `blue`: Show the tag's services in the terminal's blue color.
- `magenta`: Show the tag's services in the terminal's magenta color.
- `cyan`: Show the tag's services in the terminal's cyan color.
- `white`: Show the tag's services in the terminal's white color.
- `gray`: Show the tag's services in the terminal's gray color.
- `bright-red`: Show the tag's services in the terminal's bright-red color.
- `bright-green`: Show the tag's services in the terminal's bright-green color.
- `bright-yellow`: Show the tag's services in the terminal's bright-yellow color.
- `bright-blue`: Show the tag's services in the terminal's bright-blue color.
- `bright-magenta`: Show the tag's services in the terminal's bright-magenta color.
- `bright-cyan`: Show the tag's services in the terminal's bright-cyan color.

```yaml devlanes
tags:
  api:
    color: red
```

### `tags.<name>.description`

Type: string.

Note on what the tag groups, for people reading the config.

```yaml devlanes
tags:
  api:
    description: HTTP APIs
```
