diff --git a/customize/fonts.mdx b/customize/fonts.mdx
index c2d1a2286..3689e4abc 100644
--- a/customize/fonts.mdx
+++ b/customize/fonts.mdx
@@ -23,6 +23,10 @@ Mintlify automatically loads [Google Fonts](https://fonts.google.com) when you s
 
 To use local fonts, place your font files in your project directory and reference them in your `docs.json` configuration.
 
+<Warning>
+  Local fonts are not supported when any form of authentication is enabled on your documentation. If your site uses authentication, host your font files on a CDN or other public URL and reference them as [externally hosted fonts](#externally-hosted-fonts) instead.
+</Warning>
+
 ### Setting up local fonts
 
 <Steps>