✅ Webdock

Wavebox’s webdock is the vertical sidebar on the left of your Wavebox window. It’s your primary place to access spaces, groups, and apps—all in one spot. This article walks you through setting it up, customizing it, and solving common issues.


Getting Started

  • Locate the Webdock:
    • After installing Wavebox, the webdock appears on the left in the main Wavebox window only.
    • If it’s hidden, go to Settings > General > Webdock and switch the toggle ON.
  • Choose from 3 Layouts:
  • Contents:
    • Spaces are shown as circular icons at the top of the webdock.
    • Add Space (+) icon is shown beneath the spaces icons at the top.
    • Groups are shown as rounded-square icons.
    • Add Group (+) icon is shown beneath the last Group.
    • Apps can be shown in the webdock as smaller icons below the group icon.
    • Tabs are only shown in the webdock when in Explorer Layout.
    • Dividers are small horizontal lines available in all layouts.
    • Webdock Icons are located at the very bottom of the webdock in all layouts. Customize in ⚙️Settings > General > Webdock > Control Icons

Customizing the Webdock

Layouts

  • Go to Settings > General > Webdock Layout to show the switcher, then choose between:
    • Spaces Layout: (Default) Shows each space with their groups below.
    • List Layout: Shows all groups from all spaces in a single list.
    • Explorer Layout: Expand Spaces > Groups > Apps in a tree-style view.

Reordering & Dividers

  • Drag & Drop any icon to rearrange them (spaces, groups, apps, tabs).
  • Use Dividers: Right-click a group and select Add/Remove Divider.
  • Collapse dividers: Click on a Divider to hide less-used groups.
  • Learn more about Dividers.

Appearance

  • Change color/theme - This can be done by changing the main theme under Settings > General > Appearance > App Theme.
  • Width - When in List or Explorer layout, you can adjust the webdock width by dragging its right edge. Not available in Spaces layout.
  • Text size - Change the text size under Settings > General > Webdock > Dropdown menu. Choose from Smallest -> Largest.

Space and Group Icon Appearance

  • Spaces Opacity - Adjust the appearance of inactive spaces under Settings > General > Webdock > Inactive Spaces (button).
  • Spaces Add (+) icon - Hide the Spaces + icon under Settings > General > Webdock > Show the Space Add Button > Toggle ON or OFF.
  • Inactive (Sleeping) Groups - Choose to show sleeping groups and apps in grey under Settings > General > Appearance > Groups & Apps > Show Sleeping Groups & Apps in Grey > Toggle ON or OFF.
  • Group Icon Layout - Choose the layout of app/tabs in the group icon under Settings > General > Appearance > Groups & Apps > Grid View Dropdown:
    • Disabled - shows first app icon only, or default icon for tab only groups.
    • Show Apps - shows the first 4 app icons, with blank spaces when there is less than 4 apps.
    • Show Apps and Tabs - shows the first 4 things, whether they are apps or tabs.

Behaviour

  • Autohide - Show or hide the webdock on mouseover under Settings > General > Webdock > Toggle ON or OFF.
  • Webdock Delay - Adjust the timing of the show/hide under Settings > General > Webdock > Webdock Delay (ms).
  • Scrollbars - Unhide the webdock scrollbar under Settings > General > Webdock > Always Show Scrollbars > Toggle ON or OFF.
  • Lock / Unlock the Webdock - Right-click on any group icon and select 'Lock Webdock and Toolbars' from the bottom of the menu.

Troubleshooting

  • Webdock Missing
    • Check Settings > General > Webdock to ensure the webdock is not hidden.
  • Divider Placement Issues
    • A divider can’t sit directly above another divider. Make sure there’s at least one group below each divider.
  • Cannot Move, Delete or Edit Groups
    • It could be that the webdock is locked. To unlock it, right-click on any Group in the webdock and select 'Unlock Webdock and Toolbars' at the bottom of the menu and try again.