waybar-wlr-workspaces(5)      File Formats Manual     waybar-wlr-workspaces(5)

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> wlr (wlr
       workspaces module)

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> workspaces <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (wayland compositor)
       <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> <?><?><?> ext/workspaces <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>

       format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {name}
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       format-icons:
       <?><?><?>: array
       <?><?> <?><?><?><?> <?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?> (ICONS) <?><?>
       <?><?><?><?><?><?>.

       sort-by-name:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>. <?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?>.

       sort-by-coordinates:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> sort-by-name <?> sort-by-coordinates
       <?><?><?><?><?> true <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?>
       <?><?> false <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> (id) <?><?><?><?><?> <?><?><?><?><?>
       <?><?>.

       sort-by-id:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> (ID) <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>. <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>. <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

       all-outputs:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       active-only:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> (urgent) <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

       ignore-hidden:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (FORMAT REPLACEMENTS)
       {name}: <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>.

       {id}: <?><?><?><?><?> (ID) <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>.

       {icon}: <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       format-icons <?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (CLICK ACTIONS)
       activate: <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.

       deactivate: <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>.

       close: <?><?><?><?> <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (ICONS)
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> format-icons <?><?><?><?><?> <?><?><?>.

       o   default: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       o   active: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "ext/workspaces": {
                "format": "{name}: {icon}",
                "on-click": "activate",
                "format-icons": {
                     "Workspace 1": "<?>",
                     "Workspace 2": "<?>",
                     "Workspace 3": "<?>",
                     "Workspace 4": "<?>",
                     "active": "<?>",
                     "default": "<?>"
                },
                "sort-by-id": true
           }

<?><?><?><?><?><?> (STYLE)
       o   #workspaces
       o   #workspaces button
       o   #workspaces button.active
       o   #workspaces button.urgent
       o   #workspaces button.hidden

                                  2026-08-31          waybar-wlr-workspaces(5)