Automatic paste is a chain of several actions. Treating it as one mysterious permission problem makes diagnosis harder.
A reliable test separates the workflow into five questions:
- Did the shortcut open the overlay?
- Did the overlay respond to selection keys?
- Did it hide and return focus to the original app?
- Did the selected payload reach the system clipboard?
- Did the original app accept the paste command?
Confirm the installed app first
macOS privacy approval follows the installed application identity. A development build, moved copy, differently signed app, or stale duplicate can have a separate permission record.
Open the installed WhatTheClip build from its permanent Applications location. Avoid diagnosing with several copies open.
If macOS lists multiple old entries under Accessibility or Input Monitoring, remove the stale entries and approve the installed build again through WhatTheClip Settings.
Test the shortcut separately
If the overlay does not open:
- Confirm global hotkeys are enabled.
- Check Input Monitoring if the shortcut path requires it.
- Make sure the chosen shortcut is not already owned by macOS or another utility.
- Test from a normal text app before testing inside a remote desktop, virtual machine, game, or secure input field.
The overlay opening proves the global shortcut path. It does not yet prove paste automation.
Release the shortcut keys
Holding modifier keys while selecting an overlay item can change the event seen by the destination app. Release the original shortcut before choosing the item.
If WhatTheClip reports that shortcut keys are still held, return to the destination app, release them, and retry the sequence calmly.
Check Accessibility for automatic paste
Accessibility is used for the user-triggered paste step into another app.
If it is not approved:
- Open WhatTheClip Settings.
- Use the Accessibility setup action.
- Approve the installed WhatTheClip app under macOS Privacy & Security.
- Quit and reopen the app if macOS asks for that.
- Test with a harmless phrase in TextEdit.
TextEdit is useful because it removes browser editors, Electron apps, and complex document canvases from the first test.
Verify the original target
The overlay must remember the app and focused control that were active before it appeared. After selection, it should hide first and then restore that target before paste.
Click a clear text field before opening the overlay. If the cursor is no longer visible after the overlay closes, the target may not have regained focus.
Try manual Command-V immediately. If manual paste works and the selected item is present, the copy path succeeded and only automatic target acceptance failed.
Understand the manual fallback
A useful clipboard utility should not discard the selection just because automatic paste is blocked. WhatTheClip can leave the selected item on the system clipboard and explain that a manual Command-V is needed.
That fallback distinguishes two outcomes:
- Copied successfully: the payload is ready, but the destination did not accept automation.
- Copy failed: the payload itself could not be prepared or placed on the pasteboard.
Those are different problems and should produce different guidance.
Test text before images and files
Use a short plain-text clipping for the first test. Images and files add format negotiation, file materialization, and destination-specific rules.
Once text works:
- Test a copied image.
- Test a small local file.
- Confirm temporary file cleanup.
- Try the actual destination app.
This sequence makes it clear which payload type introduces the failure.
When one app behaves differently
Some editors, browser canvases, secure fields, and Electron applications handle focus or synthetic input differently.
Do not create a separate permanent product path for every app before confirming the universal sequence: capture target, hide overlay, restore target, place payload, and issue the normal system paste command.
Use the Permissions Guide when macOS approval is the uncertain part.