From 044efba366ead402035f3d2b01fb14a8bea11656 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 15 May 2026 20:26:35 +0000
Subject: [PATCH] docs: clarify local fonts unsupported with authentication

---
 customize/fonts.mdx | 4 ++++
 1 file changed, 4 insertions(+)

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>