diff --git a/docs/docs/config-fonts.md b/docs/docs/config-fonts.md
index 311169b3..43f07d07 100644
--- a/docs/docs/config-fonts.md
+++ b/docs/docs/config-fonts.md
@@ -27,7 +27,10 @@ by modifying the Windows Terminal settings (default shortcut: `CTRL + SHIFT + ,`
     {
         "defaults":
         {
-            "fontFace": "MesloLGM NF"
+            "font":
+            {
+                "face": "MesloLGM NF"
+            }
         }
     }
 }
diff --git a/docs/docs/install-linux.mdx b/docs/docs/install-linux.mdx
index 77139967..07db1139 100644
--- a/docs/docs/install-linux.mdx
+++ b/docs/docs/install-linux.mdx
@@ -16,6 +16,10 @@ import InstallHomebrew from "./install-homebrew.mdx";
 Oh My Posh uses ANSI color codes under the hood, these should work in every terminal,
 but you may have to set the environment variable `$TERM` to `xterm-256color` for it to work.
 
+:::info
+To display all icons, we recommend the use of a [Nerd Font][fonts].
+:::
+
 ## Installation
 
 <Tabs
@@ -72,9 +76,10 @@ When you've downloaded the themes, you can find this one at `~/.poshthemes/jande
 
 🎉🎉🎉
 
+[fonts]: /docs/config-fonts
 [scoop]: https://scoop.sh/
 [wt]: https://github.com/microsoft/terminal
 [iterm2]: https://www.iterm2.com/
 [powershell]: https://www.powershellgallery.com/packages/oh-my-posh
 [configuration]: /docs/config-overview
-[themes]: https://ohmyposh.dev/docs/themes
+[themes]: /docs/themes
diff --git a/docs/docs/install-macos.mdx b/docs/docs/install-macos.mdx
index 52fcdfce..ed696c3a 100644
--- a/docs/docs/install-macos.mdx
+++ b/docs/docs/install-macos.mdx
@@ -16,6 +16,10 @@ import InstallHomebrew from "./install-homebrew.mdx";
 As the standard terminal has issues displaying the ANSI characters correctly, we advise using
 [iTerm2][iterm2] or any other modern day MacOS terminal that supports ANSI characters.
 
+:::info
+To display all icons, we recommend the use of a [Nerd Font][fonts].
+:::
+
 ## Installation
 
 <InstallHomebrew />
@@ -30,6 +34,7 @@ As the standard terminal has issues displaying the ANSI characters correctly, we
 
 🎉🎉🎉
 
+[fonts]: /docs/config-fonts
 [scoop]: https://scoop.sh/
 [wt]: https://github.com/microsoft/terminal
 [iterm2]: https://www.iterm2.com/
diff --git a/docs/docs/install-windows.mdx b/docs/docs/install-windows.mdx
index c819e836..d06d3079 100644
--- a/docs/docs/install-windows.mdx
+++ b/docs/docs/install-windows.mdx
@@ -14,6 +14,10 @@ import CustomizeCmd from "./install-customize-cmd.mdx";
 
 While Oh My Posh works on the standard terminal, we advise using the [Windows Terminal][wt].
 
+:::info
+To display all icons, we recommend the use of a [Nerd Font][fonts].
+:::
+
 ## Install
 
 <Tabs
@@ -183,10 +187,11 @@ Inside the WSL, replace `~` with the following path: `/mnt/c/Users/<WINDOWSUSERN
 
 🎉🎉🎉
 
+[fonts]: /docs/config-fonts
 [scoop]: https://scoop.sh/
 [wt]: https://github.com/microsoft/terminal
 [powershell]: https://www.powershellgallery.com/packages/oh-my-posh
 [cc]: https://github.com/digitalcoyote
 [cc-choco]: https://github.com/digitalcoyote/chocolatey-packages/tree/master/oh-my-posh
-[linux]: https://ohmyposh.dev/docs/linux
-[themes]: https://ohmyposh.dev/docs/themes
+[linux]: /docs/linux
+[themes]: /docs/themes