---
title: "Clipboard history on Wayland not working? What works and why"
description: "On Wayland a clipboard manager can't read copies or catch keys the way it can on X11. Which desktops allow it, and how to set up Pastezo there."
url: https://pastezo.app/guides/clipboard-history-wayland
---

# Clipboard history on Wayland not working? What works and why

Linux · Updated September 30, 2026

On Wayland a clipboard manager can't read copies or catch keys the way it can on X11. Which desktops allow it, and how to set up Pastezo there.

In short

Wayland gives the clipboard only to the window in focus, so a clipboard manager needs a special permission from the desktop to see what you copy. KDE Plasma, Hyprland, Sway and other wlroots desktops give it; GNOME doesn't. Pastezo can't register its own global shortcut on Wayland, so you set the shortcut that opens the history in your desktop's keyboard settings.

## Step by step

1.  ### Check that you are on Wayland
    
    Run `echo $XDG\_SESSION\_TYPE` in a terminal. It prints `wayland` on Wayland and `x11` on X11.
    
2.  ### Install Pastezo
    
    Download the Linux build (x64 or ARM), unpack it and run `./install.sh`. It installs into `~/.local`, no root needed.
    
3.  ### Add the shortcut in your desktop
    
    Create a custom shortcut, for example `Ctrl+Shift+V`, with the command `~/.local/bin/Pastezo`. In KDE Plasma it is under System Settings → Keyboard → Shortcuts; in Sway, add a `bindsym` line to your config.
    
4.  ### Copy something and open the history
    
    Copy a line of text, press your shortcut and check that it is at the top. `Enter` pastes it; `Ctrl+1`…`9` paste the first nine clips.
    

## X11 or Wayland: what changes

On X11 any app can read the clipboard and listen for keys, which is simple and not very private. Wayland closes both doors by default and opens them only through the desktop. Copies still reach Pastezo on desktops that open the clipboard door for clipboard managers; for keys, your desktop starts Pastezo with the shortcut you give it. Everything else, from search to pins, works the same. See also [how to see clipboard history on Linux](https://pastezo.app/guides/clipboard-history-linux) and [how to open your clipboard history with a shortcut](https://pastezo.app/guides/open-clipboard-history-with-a-shortcut).

## Questions

### Why can't a clipboard manager see my copies on Wayland?

For privacy, Wayland lets only the focused window read the clipboard. A clipboard manager needs the desktop's data-control protocol to watch copies in the background, and not every desktop offers it.

### Why can't Pastezo set a global shortcut on Wayland?

On Wayland, apps can't simply listen for keys in other windows, and Pastezo doesn't register a shortcut there. Add a shortcut that runs ~/.local/bin/Pastezo in your desktop's keyboard settings instead.

### Does Pastezo work on X11 too?

Yes. On X11 it sees copies and sets its own global shortcut in Settings → General.

### What about GNOME on Wayland?

GNOME's built-in clipboard keeps only the last item. Clipboard history on GNOME usually comes from GNOME Shell extensions such as Clipboard Indicator or GPaste, which run inside the desktop itself.

## More guides

-   [How to paste something you copied earlier](https://pastezo.app/guides/paste-something-copied-earlier)
    
    Your system clipboard holds one item. Here is how to get back the link, text or image you copied an hour or a week ago, and paste it in two keystrokes.
    
-   [How to search your clipboard history](https://pastezo.app/guides/search-clipboard-history)
    
    Find any clip in seconds, even with a typo. Search by word, by the app you copied from, by type (text, link, image) and by date.
    
-   [Pastezo keyboard shortcuts](https://pastezo.app/guides/pastezo-keyboard-shortcuts)
    
    Every Pastezo shortcut on macOS, Windows and Linux in one table, plus how to set the global shortcut that opens it from any app.
    

## Try Pastezo

Free on macOS, Windows and Linux. No account, and your history stays on your computer.

[Download for macOS](https://github.com/pastezo/pastezo/releases/download/v1.0.0/Pastezo-1.0.0-macos-arm64.dmg)

Free · version 1.0.0 · [Intel Mac](https://github.com/pastezo/pastezo/releases/download/v1.0.0/Pastezo-1.0.0-macos-x64.dmg) · [All downloads](https://pastezo.app/download)
