From 84c77f57919fd3f90b1562bf823f35e20b3a18e4 Mon Sep 17 00:00:00 2001 From: densumesh Date: Tue, 25 Aug 2026 15:26:59 -0700 Subject: [PATCH 1/3] docs: explain when custom llms.txt files are public on authenticated sites --- ai/llmstxt.mdx | 4 ++++ deploy/authentication-setup.mdx | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index dee993987..04f1151dc 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -121,3 +121,7 @@ Mintlify automatically hosts an `llms-full.txt` file at the root of your project To add a custom `llms.txt` or `llms-full.txt` file, create an `llms.txt` or `llms-full.txt` file at the root of your project. Adding a custom file overrides the automatically generated file of the same name. If you delete a custom file, Mintlify restores the automatically generated file. Your custom `llms.txt` or `llms-full.txt` file must have a site title as an H1 heading. Other content is optional. See [Format](https://llmstxt.org/#format) in the `llms.txt` specification for more information on optional sections and best practices. + + +On sites that use [authentication](/deploy/authentication-setup), a custom `llms.txt` or `llms-full.txt` file is served publicly when every page it links to is public. If the file links to any page that isn't public, only authenticated users can access it and anonymous visitors get the automatically generated file instead. + diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index bf460f857..0263b41f8 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -509,7 +509,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | -| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Publicly accessible, reflecting public pages only | +| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files. Custom files that only link to public pages are public | Publicly accessible, reflecting public pages only. Custom files that only link to public pages are public | | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Full support, respects user groups. Authenticated pages export with images and assets included. | Full support, respects user groups. Authenticated pages export with images and assets included. | From 743b9aeac2292a6e8f366072664bfe8035545c2e Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 26 Aug 2026 11:18:11 -0700 Subject: [PATCH 2/3] Apply suggestion from @ethanpalm --- deploy/authentication-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index 0263b41f8..bf460f857 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -509,7 +509,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | -| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files. Custom files that only link to public pages are public | Publicly accessible, reflecting public pages only. Custom files that only link to public pages are public | +| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Publicly accessible, reflecting public pages only | | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Full support, respects user groups. Authenticated pages export with images and assets included. | Full support, respects user groups. Authenticated pages export with images and assets included. | From 283a134fbafe78a2faf98601dd9d32ce4ad3a1a1 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 26 Aug 2026 11:20:32 -0700 Subject: [PATCH 3/3] Apply suggestion from @ethanpalm --- ai/llmstxt.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index 04f1151dc..e6a3bfc21 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -123,5 +123,7 @@ To add a custom `llms.txt` or `llms-full.txt` file, create an `llms.txt` or `llm Your custom `llms.txt` or `llms-full.txt` file must have a site title as an H1 heading. Other content is optional. See [Format](https://llmstxt.org/#format) in the `llms.txt` specification for more information on optional sections and best practices. -On sites that use [authentication](/deploy/authentication-setup), a custom `llms.txt` or `llms-full.txt` file is served publicly when every page it links to is public. If the file links to any page that isn't public, only authenticated users can access it and anonymous visitors get the automatically generated file instead. +On sites that use [authentication](/deploy/authentication-setup), custom `llms.txt` and `llms-full.txt` respect authentication. + +If a custom file links to any page that ins't public, only authenticated users can access the file. Anonymous visitors receive the automatically generated `llms.txt` or `llms-full.txt`, which only include publicly available links.