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 (x86)\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 and pasting doesn’t work

This can be caused by running Wayland instead of the old X11.

Wayland doesn’t support:

  • global shortcuts
  • clipboard access from window that is not active
  • mouse selection copy/pasting
  • pasting from CopyQ (i.e. passing shortcuts to application)

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

E.g. 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

Issue #27