// 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
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
FIX 1Set a Nerd Font in the terminal
- 01Install a Nerd Font such as JetBrainsMono Nerd Font
- 02Select it in your terminal's font settings, then restart the terminal
Did this fix it?FIX 2Verify the plugin
- 01Make sure nvim-web-devicons or mini.icons is installed
- 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 usOther Neovim errors
- Neovim LSP Not Working or Not Attaching
- require('lspconfig') Is Deprecated Warning in Neovim
- Neovim Treesitter Highlighting Not Working
- Neovim Clipboard Not Working (clipboard: No provider)
- Neovim Colors Wrong in tmux
- Neovim Escape Key Delay in tmux
- Mason Failed to Install Language Server in Neovim
- Why Is Neovim So Slow? (Startup Lag and Large Files)