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

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> niri

<?><?><?> (DESCRIPTION)
       <?><?><?><?><?> workspaces <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> niri <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

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

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

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

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

       disable-click:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> true
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       disable-markup:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> pango <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       current-only:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-update:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?>.

       expand:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (FORMAT REPLACEMENTS)
       {value}: <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       niri <?><?><?><?><?> <?><?><?> <?><?><?>.

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

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

       {index}: <?><?><?><?><?> (<?><?><?><?><?>) <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       {output}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.

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

       o   default: <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.
       o   focused: <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.
       o   active: <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       o   urgent: <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> (urgent) <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.
       o   empty: <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "niri/workspaces": {
                "format": "{icon}",
                "format-icons": {
                     // Named workspaces
                     // (you need to configure them in niri)
                     "browser": "<?>",
                     "discord": "<?>",
                     "chat": "<b><?></b>",

                     // Icons by state
                     "active": "<?>",
                     "default": "<?>"
                }
           }

<?><?><?><?><?><?> (STYLE)
       o   #workspaces button
       o   #workspaces button.focused: <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?>.
       o   #workspaces button.active: <?><?><?><?> <?><?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?>) <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?>.
       o   #workspaces button.urgent: <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?>/<?><?><?><?> (urgent).
       o   #workspaces button.empty: <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?>.
       o   #workspaces button.current_output: <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.
       o   #workspaces button#niri-workspace-<name>: <?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?>.

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