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

# [NAME](#NAME)

waybar - niri workspaces module

# [DESCRIPTION](#DESCRIPTION)

The **workspaces** module displays the currently used workspaces in niri.

# [CONFIGURATION](#CONFIGURATION)

Addressed by **niri/workspaces**

**all-outputs**:  
typeof: bool  
default: false  
If set to false, workspaces will only be shown on the output they are on. If set to true all workspaces will be shown on every output.

**format**:  
typeof: string  
default: {value}  
The format, how information should be displayed.

**format-icons**:  
typeof: array  
Based on the workspace name, index and state, the corresponding icon gets selected. See **icons**.

**disable-click**:  
typeof: bool  
default: false  
If set to false, you can click to change workspace. If set to true this behaviour is disabled.

**disable-markup**:  
typeof: bool  
default: false  
If set to true, button label will escape pango markup.

**current-only**:  
typeof: bool  
default: false  
If set to true, only the active or focused workspace will be shown.

**on-update**:  
typeof: string  
Command to execute when the module is updated.

**expand**:  
typeof: bool  
default: false  
Enables this module to consume all left over space dynamically.

# [FORMAT REPLACEMENTS](#FORMAT_REPLACEMENTS)

**{value}**: Name of the workspace, or index for unnamed workspaces, as defined by niri.

**{name}**: Name of the workspace for named workspaces.

**{icon}**: Icon, as defined in **format-icons**.

**{index}**: Index of the workspace on its output.

**{output}**: Output where the workspace is located.

# [ICONS](#ICONS)

Additional to workspace name matching, the following **format-icons** can be set.

- **default**: Will be shown, when no string matches are found.
- **focused**: Will be shown, when workspace is focused.
- **active**: Will be shown, when workspace is active on its output.
- **urgent**: Will be shown, when workspace has urgent windows.
- **empty**: Will be shown, when workspace is empty.

# [EXAMPLES](#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](#Style)

- **#workspaces button**
- **#workspaces button.focused**: The single focused workspace.
- **#workspaces button.active**: The workspace is active (visible) on its output.
- **#workspaces button.urgent**: The workspace has one or more urgent windows.
- **#workspaces button.empty**: The workspace is empty.
- **#workspaces button.current\_output**: The workspace is from the same output as the bar that it is displayed on.
- **#workspaces button#niri-workspace-&lt;name&gt;**: Workspaces named this, or index for unnamed workspaces.

2026-10-30

---

Document: waybar-niri-workspaces(5) from waybar 0.15.0-r2 (Chainguard OS)