---
name: "waybar-river-tags"
section: "5"
platform: "linux"
package: "waybar"
version: "0.15.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/waybar-river-tags"
---

# waybar-river-tags(5)

river tags module

## NAME

waybar - river tags module

## DESCRIPTION

The **tags** module displays the current state of tags in river.

## CONFIGURATION

Addressed by **river/tags**

**num-tags**: \
 typeof: uint \
 default: 9 \
 The number of tags that should be displayed. Max 32.

**tag-labels**: \
 typeof: array \
 The label to display for each tag.

**disable-click**: \
 typeof: bool \
 default: false \
 If set to false, you can left-click to set focused tag. Right-click to toggle tag focus. If set to true this behaviour is disabled.

**expand**: \
 typeof: bool \
 default: false \
 Enables this module to consume all left over space dynamically.

**hide-vacant**: \
 typeof: bool \
 default: false \
 Only show relevant tags: tags that are either focused or have a window on them.

## EXAMPLE

```
"river/tags": {
	"num-tags": 5
}
```

## STYLE

- •

  **#tags button**

- •

  **#tags button.occupied**

- •

  **#tags button.focused**

- •

  **#tags button.urgent**

Note that occupied/focused/urgent status may overlap. That is, a tag may be both occupied and focused at the same time.

## SEE ALSO

[waybar(5)](/waybar/5.md), [river(1)](/river/1.md)