waybar-river-tags(5) File Formats Manual waybar-river-tags(5)

# [NAME](#NAME)

waybar - river tags module

# [DESCRIPTION](#DESCRIPTION)

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

# [CONFIGURATION](#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](#EXAMPLE)

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

# [STYLE](#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](#SEE_ALSO)

[waybar(5)](/man/enterprise-packages/waybar/waybar.5), [river(1)](/man/enterprise-packages/waybar/river.1)

2026-10-16

---

Document: waybar-river-tags(5) from waybar 0.15.0-r0 (Chainguard OS)