Help & reference
Support
Updating Workspaces, snap zones, throwing windows between displays, and answers to common questions.
Updating Workspaces
Workspaces checks for updates automatically using Sparkle. When a new version is ready, you'll see a prompt in the app. Your saved profiles are stored separately from the app and are never affected by updates.
-
Accept the automatic prompt
When a new version is available, Workspaces shows a release-notes dialog with an Install and Relaunch button. Click it — Workspaces quits, applies the update, and restarts in a few seconds. Everything picks up exactly where you left it.
-
Or check manually
Click the Workspaces menu bar icon → Settings… → Check for Updates. If a newer version is available you'll see the release notes and an install button. You can also turn off automatic background checks here if you prefer to update on your own schedule.
-
Your profiles are never touched
All your saved profiles live in
~/Library/Application Support/Workspaces/— separate from the app binary. Updates only replace the app. Your profiles, settings, and shortcuts are exactly where you left them after every update.
Snap zones
Workspaces includes a full window-snapping system — 16 zones, two ways to trigger them — so you don't need a separate window manager alongside it.
-
Drag to a pin
When you start dragging any window, snap pins appear at the edges and corners of your display. Drag toward a pin — a ghost preview shows the zone — and release to snap. Available zones: left/right/top/bottom halves, all four quarters, left/centre/right thirds, left/right two-thirds, and full screen.
-
Use the pin board
While dragging a window, move it slowly toward the centre of the screen — the pin board appears, showing all 16 zones in a grid. Drop onto any zone to snap the window there. Useful when you want a precise zone without hunting for an edge pin.
-
Use keyboard shortcuts
Every snap zone can be bound to a keyboard shortcut. Open Settings → Snap and click any zone to assign a key combo. Built-in defaults: ⌃⌥← left half · ⌃⌥→ right half · ⌃⌥↑ top half · ⌃⌥↓ bottom half · ⌃⌥U top-left · ⌃⌥I top-right · ⌃⌥J bottom-left · ⌃⌥K bottom-right.
Throwing windows between displays
On a multi-display setup, throw-to-display lets you move any window to your other monitor and have it land in the same relative position — left-half to left-half, top-right to top-right.
-
Drag toward the display edge
When two or more displays are connected, a throw-to-display pin appears at the edge of each screen that faces another monitor. Start dragging any window toward that edge — the pin lights up — and release. The window moves to the adjacent display.
-
Position is preserved
The window lands in the same relative zone on the destination display. A window that was left-half on your main display arrives left-half on the external display. Size is proportionally mapped to the destination display's dimensions, so the window fills the same fraction of the screen.
-
Enable or disable
Throw-to-display pins are on by default when multiple displays are connected, and hidden automatically on single-display Macs. To turn them off: Settings → Snap → Throw to display toggle.
Common questions
How do I update Workspaces?
Workspaces checks for updates automatically on launch and in the background. When one is ready, a dialog appears — click Install and Relaunch. To check manually: menu bar icon → Settings… → Check for Updates. Your saved profiles are never modified by updates.
How does throw-to-display work?
When you have multiple displays connected, a throw pin appears at the edge of each screen facing an adjacent display. Drag any window toward that edge and release — the window moves to the other display and lands in the same relative position. Toggle the feature in Settings → Snap → Throw to display.
Does macOS need to have Spaces pre-created?
No. Workspaces reads the Spaces you have and matches apps to them by name (Desktop 1, Desktop 2, etc.). If you've saved a profile that uses 4 Spaces and you currently only have 2, Workspaces will create the missing Spaces automatically on restore.
A window didn't move to the right Space — what happened?
A few things can interfere: apps set to "Assign to all desktops" in Mission Control (right-click the Dock icon to check), full-screen apps (take them out of full screen first), and apps that are slow to launch. Try the restore again once the app has fully loaded. If a specific app consistently fails, email support.
Does "Displays have separate Spaces" need to be on?
Yes — Workspaces requires System Settings → Desktop & Dock → Displays have separate Spaces to be enabled. This is the default on macOS; most users have it on already. If it's off, Workspaces will show a warning on launch.
Will this work if I have Stage Manager on?
Workspaces supports both Mission Control (multiple Spaces) and Stage Manager. Profile restore works best with Mission Control Spaces. Stage Manager groups are not individually addressable the same way — if you use Stage Manager, keep it on one Space and use profiles to switch between app contexts.
How do I uninstall Workspaces?
Quit the app from the menu bar (Settings → Quit), then delete Workspaces.app from your Applications folder. To remove all data, also delete ~/Library/Application Support/Workspaces/ and the Login Item ~/Library/LaunchAgents/dev.muj.workspaces.plist.
Still stuck?
Email us and we'll get back to you within 24 hours.
support@strangeattractor.ai