SUPPORT
Troubleshooting
Already using FluidZones and something's not behaving as expected? Here's what's going on and how to fix it.
01How do I change FluidZones' language?
FluidZones is available in English and Spanish:
1. Open FluidZones → Settings → General. 2. Under Language, choose System (follows your Mac's language), English or Español. 3. Click Restart Now to apply it right away, or Later to apply it the next time you open FluidZones.
If a profile is launching at that moment, the change applies the next time you open the app.
02Apps launch but windows don't move into their zones. Why?
Window positioning needs the macOS Accessibility permission. Go to System Settings → Privacy & Security → Accessibility and turn FluidZones ON.
Tip: if FluidZones already shows as enabled there but windows still don't move (typical after updating the app), the entry is stale — toggle it OFF and ON again, or remove it with “−” and re-add the app.
03What do the different checkmark colors in the launch HUD mean?
Each icon tells you exactly what happened with that app.
A filled ✓ in your theme's accent color means the app launched and its window landed exactly where you set it — everything worked perfectly.
A filled ✓ in yellow means the app launched and FluidZones tried to position it, but macOS enforced a minimum window size larger than the assigned zone — the window was anchored as close as possible to the target position.
A hollow ✓ in dim gray means the app launched, but its window ended up on a different macOS Space — FluidZones can't move windows across Spaces (a macOS limitation).
A filled ✗ in red means the app failed to open entirely.
04Why is a window bigger than its assigned zone or preset?
Some apps enforce a minimum window size and macOS silently overrides any positioning request smaller than that — no window manager can work around this OS constraint. FluidZones detects it, anchors the window to its zone's corner as close as possible, and marks it with a yellow ✓ in the launch HUD so you know the placement was adjusted.
Measured minimums for common apps: Arc ~940px wide, Fork ~640px wide. If an app lands wider than its zone, assign it a larger preset (e.g. 'First Two Thirds' instead of 'First Third') or draw a wider custom zone.
05An app launched on a different desktop (Space). Can FluidZones move it?
When an app is already open on another macOS Space, FluidZones repositions its window there — macOS doesn't provide a public API to move windows across Spaces, so no window manager can do this without using private system calls. The launch HUD marks the app with a dim ✓ and a notification tells you which app landed on another Space.
To get all apps on the same desktop, close the app before launching your scene and FluidZones will open it fresh on your current Space.
06I don't see the reminder before a scheduled launch. How do I turn it on?
Ten minutes before a scheduled profile launches, FluidZones sends a notification with Launch now, Snooze 15 min and Skip today. To make sure you see it:
1. Open System Settings → Notifications → FluidZones and turn on "Allow notifications".
2. Set the alert style to "Persistent" so the reminder stays on screen until you pick an option. With "Temporary" it disappears after a few seconds — hover over it and click "Options" to see the buttons.
3. Focus and Do Not Disturb can silence it. Even then, FluidZones won't launch over a call — the launch waits until you're free.
4. While you share your screen, macOS hides notifications unless "Allow notifications when mirroring or sharing the display" is on (System Settings → Notifications).
5. FluidZones has to be running for schedules to work — click "Launch at Login" in the schedule settings so it opens with your Mac.
If notifications are off, the schedule settings show a warning with a shortcut to turn them on.
07My scheduled profile launched later than its time, or didn't launch at all. Why?
Smart Schedules are designed never to interrupt you:
• On a call (microphone or camera in use) or using a full-screen app at the scheduled time? The launch waits and starts as soon as you're free.
• Mac asleep or locked at that time? It launches when you're back, as long as that's within 2 hours of the scheduled time. Later than that, that day's launch is skipped.
• Still busy after those 2 hours, or snoozed past them? That day's launch is skipped, and a notification tells you.
• It also won't launch if you already opened that profile yourself that day, or if you chose Skip today.
AUTOMATION
Launch from your tools
Every workspace can be started from outside FluidZones — from your launcher, the Shortcuts app, Siri, or any link. Here is how to set up each one.
01How do I launch a workspace from Raycast?
Create a Quicklink: open Raycast, run "Create Quicklink", give it a name (for example "Work Setup"), and set the link to fluidzones://launch/Work — the part after launch/ is your workspace's name. Save it.
Now type "Work Setup" in Raycast and press Enter. Want it faster? In Raycast Settings → Extensions, give the Quicklink a short alias or its own hotkey.
02How do I launch a workspace from Alfred?
In Alfred Preferences → Features → Web Search, add a Custom Search with the URL fluidzones://launch/{query}, a title such as "Launch FluidZones workspace {query}", and a keyword such as fz. Leave "Encode input as UTF8" checked (the default) so names with spaces or accents work — don't enable "Encode spaces" with a +.
Type "fz work" and Alfred opens that workspace. One search covers all of them — just type a different name.
03How do I launch a workspace with Siri or the Shortcuts app?
Open the Shortcuts app, create a new shortcut, and add the "Open URLs" action. Set its URL to your workspace's link — fluidzones://launch/Work (right-click a profile in FluidZones and choose Copy Launch URL to get it exactly). Then name the shortcut the way you'd say it out loud — "Start work", for example.
Run it from the Shortcuts menu bar item, give it a keyboard shortcut, or just say "Hey Siri, start work".
04Can I launch a workspace from Terminal or a link in my notes?
Yes. Every workspace has its own link: fluidzones://launch/ followed by the workspace name. Spaces are written as %20 — "Deep Focus" becomes fluidzones://launch/Deep%20Focus.
Anything that opens links can use it: open "fluidzones://launch/Work" in Terminal, a shell alias, or a link in Notion, Obsidian, or Apple Notes.
05The link opens FluidZones, but my workspace doesn't launch. Why?
FluidZones looks for a workspace whose name matches the part after launch/ (upper or lower case doesn't matter). If there's no match, it shows a "Profile not found" notice with the exact name it received — usually a typo, a missing %20 for a space, or a workspace that was renamed after the link was created. Update the link to the current name and it will work again.