Skip to content

Module: Tags

DreamMaoMao edited this page Aug 29, 2026 · 1 revision

Module: Tags (workspaces)

Shows the mangowm tag buttons (workspaces). Place workspaces in a modules-* list.

"modules-left": ["workspaces"],

"workspaces": {
    "hide-empty": true,
    "pinned": [1, 2],
    "tag-names": ["1", "2", "3", "", ""],
    "overview-label": "OVERVIEW",
    "on-click": "activate",
    "on-click-right": "toggle",
    "scroll-interval": 100,
    "on-scroll-up": "mmsg dispatch viewtoleft_have_client",
    "on-scroll-down": "mmsg dispatch viewtoright_have_client"
}

Options

Option Type Default Description
hide-empty bool true Hide tags without clients
pinned int array Tag numbers kept visible even when empty
tag-names string array 1..N Custom labels; index 0 = tag 1
overview-label string OVERVIEW Text shown in overview mode
on-click string activate switches to the tag over IPC
on-click-right string toggle toggles the tag over IPC
on-scroll-up / on-scroll-down string View switching commands

Styling

#tags {
    padding: 0px 13px;
    background: linear-gradient(to top, #504945, mix(#504945, #fbf1c7, 0.3));
    color: #ebdbb2;
}
#tags.active {
    background: linear-gradient(to top, #83a598, mix(#83a598, #fbf1c7, 0.3));
    color: #1b1a1a;
}
#tags.urgent {
    background: linear-gradient(to top, #fb4934, mix(#fb4934, #fbf1c7, 0.3));
    color: #1b1a1a;
}
#tags:hover {
    background: linear-gradient(to top, #665c54, mix(#665c54, #fbf1c7, 0.3));
}

Waybar-style selectors are also accepted: #workspaces button, #workspaces button:hover, #workspaces button.active, #workspaces button.urgent.

Clone this wiki locally