// troubleshooting guide · neovim

Neovim Clipboard Not Working in WSL

Status
Workaround available
platforms:
Windows (WSL)
updated:
November 21, 2026
reports:
3
Method
how we research
Share

RUNBOOK · neovim/wsl-clipboard-not-working3 FIXES

// quick answer

Neovim in WSL cannot reach the Windows clipboard unless a provider like win32yank, clip.exe/powershell or WSLg wl-clipboard is available. Set vim.g.clipboard explicitly and vim.opt.clipboard = 'unnamedplus'.

Most likely fix: Check the provider

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Check the provider

    1. 01Run :checkhealth vim.provider (or :checkhealth provider)
    2. 02Read the Clipboard section to see which tool Neovim picked
    Did this fix it?
  2. FIX 2Use win32yank or clip.exe

    1. 01Install win32yank.exe and put it on PATH, Neovim detects it automatically
    2. 02Or define vim.g.clipboard with clip.exe for copy and powershell.exe Get-Clipboard for paste
    3. 03Set vim.opt.clipboard = 'unnamedplus'
    Did this fix it?
  3. FIX 3Remove conflicting tools

    1. 01Uninstall xclip or wl-clipboard if they are selected but do not work
    2. 02Restart Neovim and re-run :checkhealth
    Did this fix it?

SANDBOX · neovim RUNS IN YOUR BROWSER

Try it: edit code in a Neovim-style modal editor

A hands-on Neovim-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Yank in Neovim does not paste into Windows apps, or :checkhealth provider reports no clipboard tool.

Why it happens

  • C-01No clipboard provider installed in the WSL distro
  • C-02A higher-priority tool (xclip, wl-copy) is picked but cannot reach Windows
  • C-03clipboard option not set to unnamedplus
  • C-04Running inside tmux without clipboard passthrough

// this guide also covers

  • neovim wsl clipboard
  • nvim yank to windows clipboard wsl
  • neovim win32yank

Still not working?

If Neovim keeps failing, you're not alone. See every Neovim problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Neovim Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Neovim errors

All 16 Neovim errors and fixes →