diff --git a/fern/products/docs/pages/ai/llms-txt.mdx b/fern/products/docs/pages/ai/llms-txt.mdx
index 133be3baa..5a4e4cb64 100644
--- a/fern/products/docs/pages/ai/llms-txt.mdx
+++ b/fern/products/docs/pages/ai/llms-txt.mdx
@@ -145,6 +145,15 @@ To authenticate your requests, include your API key in the header.
+## Per-page directives
+
+Use the [`agents` key in `docs.yml`](/learn/docs/configuration/site-level-settings#agents-configuration) to prepend a short instruction to AI agents when they fetch the Markdown version of a page, so they can discover and navigate your full docs. The directive is injected after the frontmatter metadata section but before the page body, so agents see it first even if they truncate the rest of the page. It applies to individual page Markdown (`.md`/`.mdx` URLs) and to each page section within `llms-full.txt`. Human-facing documentation is unaffected.
+
+```yaml docs.yml
+agents:
+ page-directive: "For a complete page index, fetch https://docs.example.com/llms.txt"
+```
+
## Analytics and monitoring
The [Fern Dashboard](https://dashboard.buildwithfern.com/) provides comprehensive analytics for `llms.txt` usage including:
diff --git a/fern/products/docs/pages/changelog/2026-04-02.mdx b/fern/products/docs/pages/changelog/2026-04-02.mdx
index 2bc2468f2..5a4620d4e 100644
--- a/fern/products/docs/pages/changelog/2026-04-02.mdx
+++ b/fern/products/docs/pages/changelog/2026-04-02.mdx
@@ -1,7 +1,18 @@
---
-tags: ["api-reference", "configuration", "docs.yml"]
+tags: ["ai", "configuration", "api-reference", "docs.yml"]
---
+## Per-page directives in llms.txt
+
+You can add a directive that's automatically prepended to every page when it's served to AI agents — both individual Markdown page URLs and each page section within `llms-full.txt`. The directive is only visible to agents requesting Markdown; human-facing documentation is unaffected.
+
+```yaml docs.yml
+agents:
+ page-directive: "For a complete page index, fetch https://docs.example.com/llms.txt"
+```
+
+
+
## Library docs generator
Generate MDX documentation pages from your Python or C++ library source code and include them in your Fern Docs site. Configure your libraries in `docs.yml`, run `fern docs md generate`, and the generated pages appear as navigation sections alongside your other documentation.
diff --git a/fern/products/docs/pages/customization/site-level-settings.mdx b/fern/products/docs/pages/customization/site-level-settings.mdx
index 254b6ced5..1afc5ca24 100644
--- a/fern/products/docs/pages/customization/site-level-settings.mdx
+++ b/fern/products/docs/pages/customization/site-level-settings.mdx
@@ -1017,6 +1017,19 @@ Specify [Ask Fern](/learn/ask-fern/getting-started/what-is-ask-fern) to control
+## Agents configuration
+
+Configure directives that are prepended to every page when it's [served to AI agents](/learn/docs/ai-features/llms-txt#per-page-directives).
+
+```yaml docs.yml
+agents:
+ page-directive: "For a complete page index, fetch https://docs.example.com/llms.txt"
+```
+
+
+ Text prepended to each page's Markdown output when served to AI agents. The directive is injected after the frontmatter metadata section but before the page body. Human-facing documentation is unaffected.
+
+
## AI examples configuration
Configure [AI-generated examples](/learn/docs/ai-features/ai-examples) for your API Reference pages.
diff --git a/fern/products/docs/pages/developer-tools/view-markdown.mdx b/fern/products/docs/pages/developer-tools/view-markdown.mdx
index d4066b6fe..e0b35637c 100644
--- a/fern/products/docs/pages/developer-tools/view-markdown.mdx
+++ b/fern/products/docs/pages/developer-tools/view-markdown.mdx
@@ -17,3 +17,5 @@ Displaying the page's Markdown helps with troubleshooting layout problems and ma
Fern also bundles your entire site's Markdown into [`llms.txt` and `llms-full.txt`](/learn/docs/ai-features/llms-txt) files for AI consumption. These files use the same underlying Markdown you see when viewing a single page and respect the same `` and `` content controls.
+
+You can configure a [per-page directive](/learn/docs/ai-features/llms-txt#per-page-directives) that is automatically prepended to every page's Markdown output when served to AI agents. This is useful for pointing agents to your `llms.txt` index so they can discover the rest of your docs. The directive is only visible to agents — human-facing documentation is unaffected.