.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "waybar\-dwl\-tags" "5" "2026\-08\-31"
.PP
.SH NAME
.PP
waybar \- dwl tags module
.PP
.SH DESCRIPTION
.PP
The \fBtags\fR module displays the current state of tags in dwl.\&
.PP
.SH CONFIGURATION
.PP
Addressed by \fBdwl/tags\fR
.PP
\fBnum\-tags\fR: 
.br
typeof: uint 
.br
default: 9 
.br
The number of tags that should be displayed.\& Max 32.\&
.PP
\fBtag\-labels\fR: 
.br
typeof: array 
.br
The label to display for each tag.\&
.PP
\fBdisable\-click\fR: 
.br
typeof: bool 
.br
default: false 
.br
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.\&
.PP
\fBexpand\fR: 
.br
typeof: bool 
.br
default: false 
.br
Enables this module to consume all left over space dynamically.\&
.PP
.SH EXAMPLE
.PP
.nf
.RS 4
"dwl/tags": {
	"num\-tags": 5
}
.fi
.RE
.PP
.SH STYLE
.PP
.PD 0
.IP \(bu 4
\fB#tags button\fR
.IP \(bu 4
\fB#tags button.\&occupied\fR
.IP \(bu 4
\fB#tags button.\&empty\fR
.IP \(bu 4
\fB#tags button.\&focused\fR
.IP \(bu 4
\fB#tags button.\&urgent\fR
.PD
.PP
Note that occupied/focused/urgent status may overlap.\& That is, a tag may be
both occupied and focused at the same time.\&
.PP
.SH SEE ALSO
.PP
waybar(5), dwl(1)