// troubleshooting guide · neovim

Neovim Icons Not Showing (Boxes or Question Marks)

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 21, 2026
reports:
2
Method
how we research
Share

RUNBOOK · neovim/icons-not-showing-nerd-font2 FIXES

// quick answer

Icons from nvim-web-devicons, lualine or neo-tree need a Nerd Font set in your terminal emulator, not in Neovim itself.

Most likely fix: Set a Nerd Font in the terminal

How to fix it

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

  1. FIX 1Set a Nerd Font in the terminal

    1. 01Install a Nerd Font such as JetBrainsMono Nerd Font
    2. 02Select it in your terminal's font settings, then restart the terminal
    Did this fix it?
  2. FIX 2Verify the plugin

    1. 01Make sure nvim-web-devicons or mini.icons is installed
    2. 02Run :checkhealth for the plugin and restart Neovim
    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

Empty boxes, question marks or missing glyphs in the file tree, statusline and bufferline.

Why it happens

  • C-01Terminal font is not a Nerd Font
  • C-02Terminal font fallback not configured
  • C-03Plugin devicons disabled or not installed

// this guide also covers

  • neovim icons not showing
  • nerd font neovim boxes
  • nvim-web-devicons not working

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 →