When a window will not move
Identify the conditions that fail and check the relevant settings first.
Check these in order
- Confirm permissions and system setup.
- Select the target window and press the complete assigned shortcut.
- Check whether its app is excluded under Window Management → Excluded Apps.
- For Window Snap, check enablement and the modifier condition. For Sticky Resize, check adjacent windows.
Operating-system symptoms
macOS: shortcuts stop after password entry
Finish the password entry and leave the field, then retry. If the problem continues, see Secure Input.
Windows: placement tools conflict
Check Windows Snap windows and PowerToys FancyZones. Avoid having them place the same window alongside Corral.
Windows: a fullscreen window is skipped
The default Keep fullscreen setting skips such windows. Exit fullscreen and try again. The automatic-exit option cannot guarantee success in every app.
Find a check for your symptom
| Symptom | First check |
|---|---|
| Only some apps will not move | Placement exclusions and fullscreen or special-window state |
| Shortcuts work but drag snapping does not | Enablement, modifier, and saved trigger regions |
| Two windows do not resize together | Adjacency and required modifier |
| Only mouse movements are missing from history | Undo-history exclusions |
| Some windows are missing from a snapshot | Monitor scope and visibility mode |
| A custom layout does not work on a wide display | Grid-profile compatibility |
| Settings are missing on another device | Account, Pro, and sync result |
| A Stream Deck key does not respond | Plugin, device, and approval |
Use the recovery notice at the top of settings
The action-needed notice links to the relevant settings. Use it before resetting all features.
- Some window-management features did not start: restart Corral. Saved settings are not changed.
- Displays or Window Snap settings could not be checked: open Window Snap and recheck displays.
- Some shortcuts are unavailable: distinguish conflicts from registration failures.
- Settings sync did not finish: recheck in Account. Local settings remain usable.
If restarting does not help, record the symptoms and report the problem. Do not delete all settings or app data without identifying the cause.
If the issue continues
Include your OS and Corral versions, the feature and shortcut you tried, and the affected app in your report. Do not attach a screen showing passwords or sensitive information.
If the app says some features are unavailable this run, check the recovery action shown in that notice.