Troubleshooting
Start with the issue you’re seeing. These steps cover Dock placement, display arrangements, and the controls in Dlock.
Compatibility depends on your Mac, macOS version, display arrangement, and connected hardware.
Ask your Agent for help
Choose an agent to start with a prompt about Dlock. If it can’t access the guide, copy the troubleshooting context and paste it into your conversation.
Using another agent? Copy the context and paste it into your conversation.
Dock placement
The Dock keeps moving to another display
- Open Dlock and confirm Dock Lock is enabled.
- Confirm your preferred display is selected and still connected.
- Check System Settings → Privacy & Security → Accessibility and make sure Dlock is allowed.
- Check that your bypass shortcut is not being held down.
- Quit other utilities that control Dock placement and try again.
- Select your preferred display again and leave the pointer still briefly while Dlock places the Dock.
Dlock reports Locked after it observes the Dock on the selected display and confirms its guard is active. If it does not report Locked, check the display arrangement and the steps below.
The Dock will not move to the display I selected
- Make sure your displays are extended rather than mirrored.
- Check that the selected display appears in System Settings → Displays.
- Confirm Dlock has Accessibility access.
- Close open macOS menus and leave the pointer still briefly.
- Select the display again in Dlock.
- If your displays are stacked, check that part of the chosen display’s bottom edge is exposed.
- Quit other Dock-placement utilities before trying again.
Moving the pointer or interacting during automatic placement can cancel it. Select the display again to retry.
The Dock will not stay on my upper stacked display
A bottom Dock needs an exposed part of the selected display’s bottom edge. If the display underneath covers that entire edge:
- Open System Settings → Displays → Arrange.
- Move the upper display slightly left or right until part of its bottom edge is exposed.
- Return to Dlock and select the upper display again.
Dlock’s layout tip can show a suggested offset, but you must change the arrangement in macOS.
Dlock mentions “Displays have separate Spaces”
- Open System Settings → Desktop & Dock.
- Find the Mission Control section.
- Check Displays have separate Spaces.
- Follow any macOS instruction to sign out and back in after changing it.
- Reopen Dlock and try selecting your display again.
Dlock reads this setting but does not change it for you. Behavior with Separate Spaces disabled has not been fully validated.
The left or right Dock is on the wrong screen
Vertical Dock placement follows macOS rules. Dlock cannot guarantee placement on an arbitrary interior edge of a multi-display arrangement.
For the tested display-locking path, choose Bottom in Dlock and select your preferred display.
Accessibility is enabled, but Dlock still cannot lock the Dock
- Open System Settings → Privacy & Security → Accessibility.
- Confirm Dlock is enabled.
- Fully quit and reopen Dlock, then check the permission again.
- If macOS still does not recognize access, try turning Dlock’s Accessibility permission off and back on, following any macOS prompts.
- Reopen Dlock and retry your display selection.
If you have multiple copies of Dlock, make sure the copy you are opening is the one allowed in Accessibility settings.
Displays & profiles
My preferred display is missing
- Confirm the display is powered on and connected.
- Check whether it appears in System Settings → Displays.
- Make sure displays are not mirrored if you want independent desktops.
- Check the cable, adapter, dock, or display driver if macOS cannot see it.
- Reopen Dlock’s controls and select the display when it appears.
Sidecar, AirPlay, DisplayLink, and docking-station behavior depends on the specific setup and has not been verified for every configuration.
The Dock moved after sleep or reconnecting a monitor
Dlock remembers the preferred display and attempts to restore it when the screen returns. If it does not:
- Wait for macOS to recognize the display.
- Check the arrangement in System Settings → Displays.
- Open Dlock and select the preferred display again.
- Confirm Dock Lock is on and Dlock reports Locked.
If your setup uses a profile with automatic restoration, check that the profile matches the displays currently connected.
My profile did not restore automatically
- Confirm automatic restoration is enabled for that profile.
- Check that the same display setup is connected and recognized by macOS.
- Wait for the displays to finish reconnecting.
- If the profile still does not apply, select it manually in Dlock.
Older profiles can be selected manually. Changes in adapters or how macOS identifies a display may affect matching.
Settings & controls
Which settings remain after I quit Dlock?
Dock Lock stops and normal macOS Dock switching resumes. Normal Dock preferences you changed, including position, auto-hide, and size lock, remain in effect. Changing certain preferences may briefly restart the Dock.
Dlock does not patch system files or require disabling System Integrity Protection.
Does Dlock control where Command-Tab appears?
No. Dlock manages Dock placement. macOS controls where the Command-Tab app switcher appears.
I cannot resize the Dock
Check whether Lock Dock size is enabled in Dlock. Turn it off, then resize the Dock using the macOS Dock divider or Dock settings.
The size-lock preference remains active after Dlock quits, so quitting alone does not remove it.
Check Auto-hide in Dlock or in System Settings → Desktop & Dock. Turn it off if you want the Dock to remain visible.
Auto-hide does not guarantee a hidden Dock in every full-screen, presentation, or screen-sharing situation. If the Dock is on a different display, select your preferred display and retry with Dock Lock enabled.
I cannot see the Dlock menu bar icon
The icon may be hidden by your Dlock settings or limited menu bar space.
Open Dlock from Applications or Spotlight, or use Command-Control-Option-D to reopen its controls. Check the app’s menu bar visibility setting if you want the icon shown again.
How do I completely quit Dlock?
Right-click the Dlock menu bar icon and choose Quit Dlock. Closing the controls window alone leaves Dlock running.
When Dlock quits, its Dock guard stops. Any macOS Dock settings you changed remain in effect.
Still need help?
Email . Include:
- Your Dlock version and macOS version.
- Your Mac model and number of connected displays.
- How the displays are arranged and connected.
- What you expected and what happened instead.
- Whether Dlock reports Locked.
- Any relevant error message, with private information removed.
Do not post your license key publicly.