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

<?><?><?> (NAME)
       waybar-sway-workspaces - <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> sway <?><?> waybar

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

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> sway/workspaces <?><?><?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?>.

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

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

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

       disable-scroll:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       reverse-scroll:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?> true <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?>.

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

       smooth-scrolling-threshold:
       <?><?><?>: <?><?><?> <?><?><?><?><?><?> <?><?><?><?> (double)
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       disable-scroll-wraparound:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>. <?><?><?> <?><?><?>
       true <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       enable-bar-scroll:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> true
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

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

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

       persistent-workspaces:
       <?><?><?>: json (<?><?><?><?><?> <?><?> <?><?><?><?><?><?>)
       <?><?><?><?><?><?><?>: <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

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

       disable-auto-back-and-forth:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> workspace_auto_back_and_forth
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> workspace_auto_back_and_forth <?><?> <?><?><?><?><?><?><?><?>
       Sway <?><?><?><?> <?><?><?><?>.

       alphabetical_sort:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>.
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> swaymsg workspace prev/next <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> Waybar <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?>.

       warp-on-scroll:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: true
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> (mouse warping) <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> true
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       window-rewrite:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> (Regex)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> class<...><?> title<...><?> <?><?>
           <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> Wayland <?><?><?><?><?> class <?><?>
           app_id <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> X11 <?><?> <?><?><?><?><?>
           class <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       window-rewrite-default:
           <?><?><?>: <?><?><?><?> (string)
           <?><?><?><?><?><?><?>: "?"
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> window-rewrite <?><?><?><?><?><?>
           <?><?><?><?><?>.

       format-window-separator:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: " "
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

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

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

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

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

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

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

       {windows}: <?><?><?><?><?> <?><?><?><?> <?><?> window-rewrite.

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

       o   default: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       o   urgent: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.
       o   focused: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> (<?><?><?><?><?>) <?><?><?><?>.
       o   persistent: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>.
       o   high-priority-named: <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (PERSISTENT WORKSPACES)
       <?><?> <?><?><?><?><?> <?><?> persistent_workspace <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>.

           "sway/workspaces": {
                "persistent-workspaces": {
                     "3": [], // <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> '3' <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
                     "4": ["eDP-1"], // <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> '4' <?><?><?> <?><?><?><?><?> 'eDP-1' <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
                     "5": ["eDP-1", "DP-2"] // <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> '5' <?><?><?> <?><?><?><?><?><?><?><?><?> 'eDP-1' <?> 'DP-2' <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
                }
           }

       <?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> swaymsg -t get_outputs <?><?> <?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "sway/workspaces": {
                "disable-scroll": true,
                "all-outputs": true,
                "format": "{name}: {icon}",
                "format-icons": {
                     "1": "<?>",
                     "2": "<?>",
                     "3": "<?>",
                     "4": "<?>",
                     "5": "<?>",
                     "high-priority-named": [ "1", "2" ],
                     "urgent": "<?>",
                     "focused": "<?>",
                     "default": "<?>"
                }
           }

           "sway/workspaces": {
             "format": "<span size='larger'>{name}</span> {windows}",
             "format-window-separator": " | ",
             "window-rewrite-default": "{name}",
             "window-rewrite": {
               "class<firefox>": "<?>",
               "class<kitty>": "k",
                "title<.* - (.*) - VSCodium>": "codium $1"  // <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
             }
           }

<?><?><?><?><?><?> (STYLE)
       o   #workspaces button
       o   #workspaces button.visible
       o   #workspaces button.focused
       o   #workspaces button.urgent
       o   #workspaces button.persistent
       o   #workspaces button.empty
       o   #workspaces button.current_output
       o   #workspaces button#sway-workspace-${name}

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