Skip to content

Widgets Spacer

prankstr edited this page Feb 18, 2026 · 2 revisions

Spacer

A layout primitive for controlling widget positioning. Spacers either expand to fill available space or have a fixed width.

Options

Option Type Default Description
width integer Fixed width in pixels (omit for flexible)

Inline syntax:

[widgets]
left = ["workspaces", "spacer", "clock"]      # flexible - expands to fill
left = ["workspaces", "spacer:50", "clock"]   # fixed 50px width

Use Cases

Push widgets to the edge of a section:

left = ["workspaces", "spacer", "clock"]  # clock pushed to right edge of left section

Create a gap in the center (e.g., for a display notch):

[widgets]
left = ["workspaces", "spacer", "window_title"]
center = ["spacer:200"]  # 200px gap for notch
right = ["clock", "spacer", "battery"]

Fixed spacing between widgets:

left = ["workspaces", "spacer:20", "clock"]  # 20px gap

Note: The spacer widget does not support the background_color option.

Clone this wiki locally