diff --git a/fern/docs.yml b/fern/docs.yml
index 60cece5ce7..d6dbf4896e 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -849,7 +849,9 @@ redirects:
   - source: /learn/docs/ai-features/ask-fern/discord-bot
     destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/docs/ai-features/ask-fern/search-widget
-    destination: /learn/docs/ai-features/ask-fern/search-widget/overview
+    destination: /learn/docs/ai-features/search-widget/overview
+  - source: /learn/docs/ai-features/ask-fern/search-widget/:slug
+    destination: /learn/docs/ai-features/search-widget/:slug
 
   # /learn/ai-search/* (legacy) — specifics before catchall
   - source: /learn/ai-search/getting-started/ai-search-customer-showcase
diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml
index 002c41ff54..e7a1bcf201 100644
--- a/fern/products/docs/docs.yml
+++ b/fern/products/docs/docs.yml
@@ -203,9 +203,6 @@ navigation:
                   - page: Additional content sources
                     path: ./pages/ask-fern/content-sources.mdx
                     slug: content-sources
-                  - page: Standalone widgets
-                    path: ./pages/ask-fern/search-widget.mdx
-                    slug: search-widget
               - api: API reference
                 api-name: fai
                 paginated: true
@@ -220,12 +217,27 @@ navigation:
                       - slackScribe
                     hidden: true
                     contents: []
+          - section: Standalone widgets
+            slug: search-widget
+            contents:
+              - page: Overview
+                path: ./pages/ask-fern/search-widget.mdx
+                slug: overview
+              - page: Search modal with AI chat
+                path: ./pages/ask-fern/search-modal.mdx
+                slug: search-modal
+              - page: Ask AI chat panel
+                path: ./pages/ask-fern/ask-ai-chat.mdx
+                slug: ask-ai-chat
           - page: MCP server for your site
             path: ./pages/ai/mcp-server.mdx
             slug: mcp-server
           - page: Custom skills for your site
             path: ./pages/ai/host-skills.mdx
             slug: host-skills
+          - page: API catalog discovery
+            path: ./pages/ai/api-catalog.mdx
+            slug: api-catalog
       - section: For building your docs
         skip-slug: true
         contents:
diff --git a/fern/products/docs/pages/ask-fern/ask-ai-chat.mdx b/fern/products/docs/pages/ask-fern/ask-ai-chat.mdx
index ccd9517b72..929786dfa7 100644
--- a/fern/products/docs/pages/ask-fern/ask-ai-chat.mdx
+++ b/fern/products/docs/pages/ask-fern/ask-ai-chat.mdx
@@ -3,7 +3,7 @@ title: Ask AI chat panel
 description: Embed Fern's Ask AI chat panel in any React application, with a floating, inline, or custom trigger.
 ---
 
-`AskAiChat` renders a sidebar panel with AI chat (no keyword search). It's one of the two components in the [`@fern-api/search-widget` package](/learn/docs/ai-features/ask-fern/search-widget/overview), which covers the prerequisites and the Content Security Policy the widget needs.
+`AskAiChat` renders a sidebar panel with AI chat (no keyword search). It's one of the two components in the [`@fern-api/search-widget` package](/learn/docs/ai-features/search-widget/overview), which covers the prerequisites and the Content Security Policy the widget needs.
 
 <Frame caption="The `AskAiChat` component embedded in a marketing site.">
   <video
diff --git a/fern/products/docs/pages/ask-fern/search-modal.mdx b/fern/products/docs/pages/ask-fern/search-modal.mdx
index 800fb491da..346d15a9c5 100644
--- a/fern/products/docs/pages/ask-fern/search-modal.mdx
+++ b/fern/products/docs/pages/ask-fern/search-modal.mdx
@@ -3,7 +3,7 @@ title: Search modal with AI chat
 description: Embed Fern's search modal, combining keyword search with AI chat, in any React application.
 ---
 
-`SearchModal` renders a trigger button that opens a modal over the page, combining keyword search with AI chat. It's one of the two components in the [`@fern-api/search-widget` package](/learn/docs/ai-features/ask-fern/search-widget/overview), which covers the prerequisites and the Content Security Policy the widget needs.
+`SearchModal` renders a trigger button that opens a modal over the page, combining keyword search with AI chat. It's one of the two components in the [`@fern-api/search-widget` package](/learn/docs/ai-features/search-widget/overview), which covers the prerequisites and the Content Security Policy the widget needs.
 
 <Frame caption="The `SearchModal` component embedded in a dashboard. Try the [live demo](https://fern-demo.github.io/fern-search-widget-demo/) or browse the [demo source](https://github.com/fern-demo/fern-search-widget-demo).">
   <video
diff --git a/fern/products/docs/pages/ask-fern/search-widget.mdx b/fern/products/docs/pages/ask-fern/search-widget.mdx
index bb797c5a68..c90e2793a7 100644
--- a/fern/products/docs/pages/ask-fern/search-widget.mdx
+++ b/fern/products/docs/pages/ask-fern/search-widget.mdx
@@ -6,8 +6,8 @@ description: Embed Fern's AI-powered search and Ask AI chat in any React applica
 The [`@fern-api/search-widget`](https://www.npmjs.com/package/@fern-api/search-widget) package provides standalone React components that search and answer questions from your documentation anywhere outside your Fern Docs site. Embed them in your dashboard, marketing site, or internal tool so users can get answers without leaving their workflow.
 
 The package ships two components:
-*  [`SearchModal`](/learn/docs/ai-features/ask-fern/search-widget/search-modal), a modal that opens over the page and combines keyword search with AI chat
-*  [`AskAiChat`](/learn/docs/ai-features/ask-fern/search-widget/ask-ai-chat), a sidebar panel with AI chat (no keyword search), with floating, inline, and custom trigger options
+*  [`SearchModal`](/learn/docs/ai-features/search-widget/search-modal), a modal that opens over the page and combines keyword search with AI chat
+*  [`AskAiChat`](/learn/docs/ai-features/search-widget/ask-ai-chat), a sidebar panel with AI chat (no keyword search), with floating, inline, and custom trigger options
 
 <AccordionGroup>
   <Accordion title="SearchModal" defaultOpen={true}>
@@ -66,14 +66,14 @@ Then follow the component page for usage, customization, and the full list of pr
   <Card
     title="Search modal with AI chat"
     icon="regular magnifying-glass"
-    href="/learn/docs/ai-features/ask-fern/search-widget/search-modal"
+    href="/learn/docs/ai-features/search-widget/search-modal"
   >
     `SearchModal`, a modal combining keyword search with AI chat.
   </Card>
   <Card
     title="Ask AI chat panel"
     icon="regular sparkles"
-    href="/learn/docs/ai-features/ask-fern/search-widget/ask-ai-chat"
+    href="/learn/docs/ai-features/search-widget/ask-ai-chat"
   >
     `AskAiChat`, a sidebar chat panel with floating, inline, and custom triggers.
   </Card>
diff --git a/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx b/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx
index 330f2aa8b8..305eb6dbb1 100644
--- a/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx
+++ b/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx
@@ -55,7 +55,7 @@ Ask Fern is Fern's AI Search feature, powered by [Claude 4.6 Sonnet](https://www
   <Card
     title="Standalone widgets"
     icon="regular magnifying-glass"
-    href="/learn/docs/ai-features/ask-fern/search-widget/overview"
+    href="/learn/docs/ai-features/search-widget/overview"
   >
     Embed Ask Fern in any React application.
   </Card>
diff --git a/fern/products/docs/pages/changelog/2026-04-09.mdx b/fern/products/docs/pages/changelog/2026-04-09.mdx
index cb3ba0a477..4cd98893b1 100644
--- a/fern/products/docs/pages/changelog/2026-04-09.mdx
+++ b/fern/products/docs/pages/changelog/2026-04-09.mdx
@@ -28,4 +28,4 @@ Embed Ask Fern's AI-powered search on any React site using the [`@fern-api/searc
   </video>
 </Frame>
 
-<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/ask-fern/search-widget/search-modal">Read the docs</Button>
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/search-widget/search-modal">Read the docs</Button>
diff --git a/fern/products/docs/pages/changelog/2026-08-17.mdx b/fern/products/docs/pages/changelog/2026-08-17.mdx
index afa961fbd9..856b89c954 100644
--- a/fern/products/docs/pages/changelog/2026-08-17.mdx
+++ b/fern/products/docs/pages/changelog/2026-08-17.mdx
@@ -14,4 +14,4 @@ The [`@fern-api/search-widget`](https://www.npmjs.com/package/@fern-api/search-w
   </video>
 </Frame>
 
-<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/ask-fern/search-widget/ask-ai-chat">Read the docs</Button>
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/search-widget/ask-ai-chat">Read the docs</Button>
diff --git a/fern/products/docs/pages/customization/search.mdx b/fern/products/docs/pages/customization/search.mdx
index 8ff6050226..9f01890b9d 100644
--- a/fern/products/docs/pages/customization/search.mdx
+++ b/fern/products/docs/pages/customization/search.mdx
@@ -116,7 +116,7 @@ Fern configures Algolia's ranking to prioritize matches in high-signal attribute
 
 ## Integrating with Algolia
 
-If you need to integrate Fern's documentation search into your own application or dashboard, you can use the [standalone widgets](/learn/docs/ai-features/ask-fern/search-widget/overview) to embed a ready-made React search or chat component, or request Algolia credentials directly from the Fern team to build a custom integration.
+If you need to integrate Fern's documentation search into your own application or dashboard, you can use the [standalone widgets](/learn/docs/ai-features/search-widget/overview) to embed a ready-made React search or chat component, or request Algolia credentials directly from the Fern team to build a custom integration.
 
 ### Making search requests