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

# [NAME](#NAME)

waybar - dwl tags module

# [DESCRIPTION](#DESCRIPTION)

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

# [CONFIGURATION](#CONFIGURATION)

Addressed by **dwl/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.

# [EXAMPLE](#EXAMPLE)

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

# [STYLE](#STYLE)

- **#tags button**
- **#tags button.occupied**
- **#tags button.empty**
- **#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), [dwl(1)](/man/enterprise-packages/waybar/dwl.1)

2026-11-02

---

Document: waybar-dwl-tags(5) from waybar 0.15.0-r3 (Chainguard OS)