Known Issues

This document lists known commonly occurring issues and possible solutions.

On Windows, tray icon is hidden/repositioned after restart

With current official builds of CopyQ, the tray icon position and hide/show status are not restored after the application is restarted or after logging in.

Workaround is to use CopyQ binaries build with older Qt framework version (Qt 5.9); these are provided in latest comments in the issue link below.

See also

Issue #1258

On Windows, CopyQ does not print anything on console

On Windows, you may not see any output when executing CopyQ in a console/terminal application (PowerShell or cmd).


  • Use different console application: Git Bash, Cygwin or similar.

  • Use Action dialog in CopyQ (F5 shortcut) and set “Store standard output” to “text/plain” to save the output as new item in current tab.

  • Append | Write-Output to commands in PowerShell:

    & 'C:\Program Files\CopyQ\copyq.exe' help | Write-Output

See also

Issue #349

On macOS, CopyQ won’t paste after installation/update

CopyQ is not signed app, you need to grant Accessibility again when it’s installed or updated.

To fix this, try following steps:

  1. Go to System Preferences -> Security & Privacy -> Privacy -> Accessibility (or just search for “Allow apps to use Accessibility”).

  2. Click the unlock button.

  3. Select CopyQ from the list and remove it (with the “-” button).

On Linux, global shortcuts, pasting or clipboard monitoring does not work

This can be caused by running CopyQ under a Wayland window manager instead of the X11 server.

Depending on the desktop environment, these features may not be supported:

  • global shortcuts

  • clipboard monitoring

  • pasting from CopyQ and issuing copy command to other apps (that is passing shortcuts to application)

  • screenshot functionality

  • querying keyboard modifiers and mouse position

Workaround for most problems is to set QT_QPA_PLATFORM environment variable and use Xwayland (e.g. xorg-x11-server-Xwayland Fedora package).

For example, launch CopyQ with:

env QT_QPA_PLATFORM=xcb copyq

If CopyQ autostarts, you can change Exec=... line in ~/.config/autostart/copyq.desktop:

Exec=env QT_QPA_PLATFORM=xcb copyq


Mouse selection will still work only if the source application itself supports it.

See also

Wayland Support command reimplements some features on Wayland through external tools (see README for details on how to add the command.

Issue #27