If Powerlevel10k icons and git branch symbols show up as empty boxes or question marks in VS Code’s integrated terminal, VS Code is using a font that doesn’t include Nerd Font glyphs. To fix it, set terminal.integrated.fontFamily in VS Code settings to the same Nerd Font your terminal app uses. In my case that is MesloLGM Nerd Font Mono.
The font problem in VS Code
After I finished the setup in Terminal Mastery: Crafting a Productivity Environment with iTerm, tmux, and Beyond, I had a nice terminal:
Then I installed VS Code. Its integrated terminal couldn’t display the Nerd Font glyphs. The Powerlevel10k icons and the git branch symbol showed up as empty boxes or question marks.
Why it happens: VS Code doesn’t read iTerm2’s font settings. If terminal.integrated.fontFamily is empty, the integrated terminal falls back to your editor font. Most editor fonts don’t include the extra icon glyphs that Nerd Fonts add, so the prompt renders those characters as placeholders.
The fix
1. Find the exact font family name
On a Mac, open Font Book and look up the Nerd Font you installed:
The font that has these glyphs is “MesloLGM Nerd Font Mono”. That is also the font I configured for iTerm2. Use the family name exactly as Font Book shows it, including spaces and capitals.
2. Set the terminal font in VS Code
- Press Command + , to open Settings.
- Search for
terminal.integrated.fontFamily. - Enter the font family name:
If you prefer to edit settings.json directly, add this line:
"terminal.integrated.fontFamily": "MesloLGM Nerd Font Mono"3. Check the terminal
Open the integrated terminal again. The icons should now display correctly:
If nothing changes, close the terminal panel, open a new terminal, and check the font name for typos.
Quick reference
| Step | Where | What to do |
|---|---|---|
| Find font name | Font Book (macOS) | Copy the Nerd Font family name, e.g. MesloLGM Nerd Font Mono |
| Open settings | VS Code, Command + , | Search terminal.integrated.fontFamily |
| Set font | Settings UI or settings.json | "terminal.integrated.fontFamily": "MesloLGM Nerd Font Mono" |
| Verify | New integrated terminal | Prompt icons and git branch symbol render |
FAQ
Why does my prompt look fine in iTerm2 but broken in VS Code?
Each app has its own font setting. iTerm2 uses the Nerd Font you picked in its profile. VS Code’s integrated terminal uses terminal.integrated.fontFamily, or your editor font if that setting is empty.
Do I need to change my editor font too?
No. terminal.integrated.fontFamily only affects the integrated terminal, so your code editor can keep its current font.
How do I find the font name on Linux?
Run fc-list | grep -i nerd to list installed Nerd Fonts and their family names. Use the family name in the same VS Code setting.
I set the font and still see boxes. What now? First make sure the Nerd Font is installed on the machine where VS Code is running. Then confirm the name matches exactly, and open a new terminal tab.
Well done! Thanks for reading. Feel free to check out my other posts below, or reach out via the contact page.