diff --git a/changelog.mdx b/changelog.mdx
index 57cfd65af..314c5c3fb 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -6,11 +6,12 @@ mode: "center"
## API playground stability updates
+
- Search to find an endpoint
- Indicate a deprecated endpoint with a tag
- Hide auto-generated API pages from navigation
- Upload multipart or form data files
-
+
Learn more at [API playground docs.](/api-playground/)
## `mint update`
@@ -21,9 +22,8 @@ mode: "center"
## Web Editor 3.0
- 
+ 
-
Overhauled usability in the WYSIWYG editor.
**Major improvements**
@@ -173,12 +173,12 @@ mode: "center"
- ## AI Assistant
+ ## AI Writer
- You can now ask AI to make changes to your docs, with the context of all existing documentation. Type in a prompt and the assistant will propose changes by generating a pull request.
+ You can now ask AI to make changes to your docs, with the context of all existing documentation. Type in a prompt and the writer will propose changes by generating a pull request.
## GitLab Integration Upgrade
@@ -461,4 +461,4 @@ mode: "center"
- Snippets V2: We now support fully reusable components and variables for snippets.
- Open-source MDX Engine: We've exposed two APIs—getCompiledMdx and MDXComponent—so you can access Mintlify markdown and code syntax highlighting. [Contributions to the project](https://github.com/mintlify/mdx) are welcome.
- AI Chat Insights: Segment chat history by date and increase AI Chat quota from the dashboard, and see how often a specific query appears.
-
+
\ No newline at end of file
diff --git a/docs.json b/docs.json
index 684eb1249..8754d8954 100644
--- a/docs.json
+++ b/docs.json
@@ -112,6 +112,7 @@
"group": "Guides",
"pages": [
"guides/migration",
+ "guides/assistant",
"mcp",
"guides/cursor",
"translations",
diff --git a/guides/assistant.mdx b/guides/assistant.mdx
new file mode 100644
index 000000000..3bfd835ae
--- /dev/null
+++ b/guides/assistant.mdx
@@ -0,0 +1,275 @@
+---
+title: "AI Assistant"
+description: "Help users succeed with your product and find answers faster"
+icon: "bot"
+---
+
+
+ The AI assistant is available on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant).
+
+
+## About the assistant
+
+The assistant answers questions about your documentation through natural language queries. When users ask a question, the assistant searches your content, cites relevant sources, and provides contextual answers sourced from your documentation.
+
+The assistant uses agentic RAG (retrieval-augmented generation) with tool calling and runs on Claude Sonnet 4 by default.
+
+You can monitor user interactions and export query data from your dashboard to gain insights into user needs and identify content gaps.
+
+The assistant is automatically enabled for accounts on Pro, Growth, and Enterprise plans. See [Pricing](https://mintlify.com/pricing) for details.
+
+## Using the assistant
+
+Users can access the assistant in two ways:
+
+- **Keyboard shortcut**: Command + I (Ctrl + I on Windows)
+- **Assistant button** next to the search bar
+ 
+ 
+
+Both methods open a chat panel on the right side of your docs. Users can ask any question and the assistant will search your documentation for an answer. If no relevant information is found, the assistant will respond that it cannot answer the question.
+
+## Making content AI ingestible
+
+Structure your documentation to help the assistant provide accurate, relevant answers. Clear organization and comprehensive context benefit both human readers and AI understanding.
+
+
+ - Use semantic markup.
+ - Write descriptive headings for sections.
+ - Create a logical information hierarchy.
+ - Use consistent formatting across your docs.
+ - Include comprehensive metadata in page frontmatter.
+ - Break up long blocks of text into shorter paragraphs.
+
+
+
+ - Define specific terms and acronyms when first introduced.
+ - Provide sufficient conceptual content about features and procedures.
+ - Include examples and use cases.
+ - Cross-reference related topics.
+ - Add [hidden pages](/guides/hidden-pages) with additional context that users don't need, but the assistant can reference.
+
+
+## Exporting and analyzing queries
+
+Review and export queries from your dashboard to understand how people interact with your documentation and identify improvement opportunities. Some ways that analyzing queries can help you improve your documentation:
+
+- Identify content gaps where frequent queries receive insufficient answers.
+- Discover user behavior patterns and common information needs from themes and patterns in queries.
+- Prioritize high-traffic pages for accuracy and quality improvements.
+
+You can explore queries from your [dashboard](https://dashboard.mintlify.com/products/assistant), but to get more powerful insights we recommend exporting a `CSV` file of your queries, responses, and sources to analyze with your preferred AI tool.
+
+1. Navigate to the [assistant page](https://dashboard.mintlify.com/products/assistant) in your dashboard.
+2. Select **Export to CSV**.
+3. Analyze the exported data using your preferred tool.
+
+
+ - Summarize the most common themes of the queries.
+ - List any queries that had no sources cited.
+ - Find patterns in unsuccessful interactions.
+
+
+## Changing the model
+
+The assistant uses Claude Sonnet 4 by default. We have found that this model performs the best when searching and answering questions.
+
+If you want to select another model:
+
+1. Navigate to the [assistant page](https://dashboard.mintlify.com/products/assistant) in your dashboard.
+2. Select **Manage**.
+3. Choose your preferred model.
+4. Select **Save**.
+
+Available models:
+
+
+
+
+
+ }
+ />
+
+
+
+ }
+ />
+
+
+
+ }
+ />
+
+
+
+ }
+ />
+
+
+
+ }
+ />
+
+
+
+
+
+
+
+
+
+
+ }
+ />
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ }
+ />
+
+
+
+
+ }
+ />
+
\ No newline at end of file
diff --git a/guides/hidden-pages.mdx b/guides/hidden-pages.mdx
index ad75ec40a..dc7f02dad 100644
--- a/guides/hidden-pages.mdx
+++ b/guides/hidden-pages.mdx
@@ -16,11 +16,13 @@ If you want to hide pages for specific groups of users, use personalization to c
A page is hidden if it is not included in your `docs.json` navigation. To hide a page, remove it from your navigation structure.
+Hidden pages use the same URL structure as regular pages based on their file path. For example, `guides/hidden-page.mdx` would be accessible at `docs.yoursite.com/guides/hidden-page`.
+
-Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages.
+ Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages.
-## Search, SEO, and AI context
+## Search, SEO, and AI indexing
By default, hidden pages are excluded from indexing for search engines, internal search within your docs, and as context for the AI assistant. To include hidden pages in search results and as context for the assistant, add the `seo` property to your `docs.json`:
@@ -30,4 +32,4 @@ By default, hidden pages are excluded from indexing for search engines, internal
}
```
-To exclude a specific page, add `noindex: "true"` to its frontmatter.
+To exclude a specific page, add `noindex: "true"` to its frontmatter.
\ No newline at end of file
diff --git a/images/assistant/assistant-button-dark.png b/images/assistant/assistant-button-dark.png
new file mode 100644
index 000000000..3520125cf
Binary files /dev/null and b/images/assistant/assistant-button-dark.png differ
diff --git a/images/assistant/assistant-button-light.png b/images/assistant/assistant-button-light.png
new file mode 100644
index 000000000..0fa2edc48
Binary files /dev/null and b/images/assistant/assistant-button-light.png differ