Product updates

​

Major releases

• Major enhancement: AI suggested pages on 404 pages, when someone hits a dead link → AI agent reads the path → suggests semantically similar pages
• Major release: web search for assistant can now include external sources
  Note: Contact us to enable this feature for your site.

​

Assistant and MCP

• Fixed a bug where the assistant would be incorrectly rate limited due to time window not sliding correctly
• Fixed a bug with assistant tool calling to properly handle empty text blocks
• Fixed a bug where MCP server name’s concatenated with tool calls were sometimes exceeding the 60 character length MCP clients enforce
• Fixed a bug where the assistant menu would have a height several times larger than the viewport and scroll forever
• Fixed a bug where assistant spend values could display with greater than two decimal places in the dashboard

​

Web editor and deployments

• Security enhancement added to editor such that only users with write permissions for the connected git hosting repository can make changes
• Fixed a bug where preview deployments wouldn’t work for branches with = in the name
• Fixed a bug where long branch names would overflow modals on preview deployment creations
• Quality of life improvement where email query parameter will prefill the input on signup invitations
• Fixed a bug where copying a page from the context menu was not working on safari

​

API playground and navigation

• Multiple API playground response codes now display in a controlled styled select menu instead of the system default select menu when focused
• You can now use the expanded field on navigation groups in your docs.json to make them be default open

​

SEO and UI

• Fixed a bug where favicons were not showing up in search engines by serving them from the same URL as the documentation site itself for each respective site
• Fixed a bug where youtube embeds would flash in and out on load
• Fixed a bug where expanding the feedback menu to include written responses would cause layout shift with the table of contents
• Fixed a bug where text would leak above the topbar on the maple theme when a dismissed the notification banner
• Enhanced the Maple and Willow themes by adding login/logout buttons to the sidebar for easier access

​

Analytics and exports

• Fixed reliability issues with assistant analytics view and exports
• Assistant analytics exports are now executed in the background and sent via email for a more reliable experience

​

Major release: Enhanced feedback collection

• Major improvement: Readers can now give more detailed feedback after selecting thumbs up/down, including options and written comments. You can also collect feedback on code blocks and view all responses in your dashboard analytics.
  Note: Contact us to enable this feature for your site.

​

Navigation and quality of life improvements

• Quality of life improvement to ignore trailing slashes and double slashes so you don’t have to worry about getting them exactly right in your docs.json
• You can now add a noAnchor attribute to your h1-6 HTML tags to avoid them having an anchor link
• The Palm theme now has a floating language selector in the bottom left similar to Stripe’s approach
• Added a new field to the docs.json called drilldown which allows you to control whether or not users are navigated to the first page in a navigation group when the group is expanded
• Quality of life improvement to make nested ordered lists alternate styles from decimal/Roman to alpha

​

Bug fixes and reliability

• Fixed a bug where scroll position anchor links weren’t working correctly when there were JS components on a page
• Fixed a bug where Google was indexing raw *.md files because they were missing a x-robots-tag noindex header
• Fixed a bug with OAuth on protected docs where it wouldn’t redirect you back to your starting page once you completed the flow successfully
• Fixed a bug on previews of auth protected docs where you weren’t able to see the entire navigation bar
• Bug fixes to how SVGs are handled with our new image CDN

​

Component and styling enhancements

• Added a new CSS selector for custom styles on SidebarNavGroupDivider
• New regression tests for MDX defined API pages that have security defined on them will ensure a greater degree of stability

​

Performance improvements

• Performance improvement by moving the KaTeX CSS from cdnjs to our own CDN on Cloudfront for reduced latency

​

Image handling improvements

• Major improvement: Images no longer cause layout shift by default, even when width and height attributes aren’t specified—automatic sizing prevents content jumping during page loads
• All static files in your repository (PDF, TXT, XML, etc.) are now automatically uploaded and served when you deploy, providing complete asset coverage

​

Web editor and deployment enhancements

• Fixed branch creation workflow in web editor to correctly navigate to and stay on newly created branches
• Enhanced merge conflict dialog with proper escape functionality, no more page reloads required to dismiss conflicts
• Optimized update workflow performance by cache-invalidating only changed pages during partial updates, reducing deployment times

​

Authentication and navigation improvements

• New support for authentication on custom subdirectories, if you serve docs at https://yourdomain.com/docs, authentication now works seamlessly
• Fixed sidebar display bug that incorrectly showed when only one link was configured
• Comprehensive mobile navigation overhaul: centered buttons with proper margin/padding, improved spacing in dropdown menus, removed unnecessary dividers and margins for empty sections, and fixed Maple theme gap/padding issues

​

Component and styling fixes

• Resolved <h1-6> tag conversion issue that was incorrectly transforming them into Heading components and disrupting custom styling
• One-click assistant configuration toggle added to dashboard for easier management

​

Technical improvements and reliability

• Enhanced logging system for update workflows enabling faster debugging and issue resolution
• Fixed GitHub rate limiting for customers with 10+ OpenAPI/AsyncAPI specs by switching from individual file fetching to repository cloning
• Improved assistant reliability with backup LLM support, enhanced rate limit error handling, and more robust search tool functionality

​

Performance and build optimizations

• MDX transpilation now happens at deployment time instead of on every page load in uncached NextJS serverless environments, improving time to first byte for uncached pages.
• Content-based hashing prevents re-transpilation when MDX hasn’t changed, reducing update workflow times by ~50% for customers with large page counts (deployments over 5 minutes should be roughly halved)
• Preview deployment viewing in the dashboard is now faster with added database indexes and query parallelization in our backend
• Reduced page size by eliminating duplicate navigation data in each page’s rsc payload—performance gains most noticeable with high page counts or complex navigation structures
• More aggressive prefetching enables instant page loads more frequently

​

API playground and OpenAPI enhancements

• OpenAPI to MCP conversion moved to backend, enabling hosted MCP servers to contain tools (expect clearer documentation and config options soon)
• Added Ruby support to API playground
• We added a feature such that you can now specify API pages using just your docs.json without creating any new mdx files.
• Support for webhook pages in docs navigation from OpenAPI specs
• Optimized AI model context by removing anchor link specifications from markdown links when navigating to Anthropic, OpenAI, or other providers

​

Web editor improvements

• File creation/renaming now saves changes when clicking away instead of requiring Enter key press
• Fixed branch navigation where changing URL to specific branch would redirect to last active branch instead of intended destination
• Properly URL encode branch titles containing / to prevent navigation breakage
• Fixed Ctrl+K link shortcut in monorepo dashboard Editor that was prepending docs repo path and creating broken links

​

Analytics and LLM integrations

• Custom llms.txt and llms-full.txt support—add to docs repo root to serve at /llms.txt and /llms-full.txt endpoints for LLM customization
• Added Hightouch analytics integration
• Enhanced context menu analytics tracking (dashboard viewing coming soon)
• Added e2e tests for llms.txt and llms-full.txt to ensure correct serving

​

Component and styling enhancements

• Support for custom classnames in h{1-4} tags for applying custom heading styles
• Fixed h{1-4} tags rendering as Heading components with chips in custom page mode
• Added CSS selectors to breadcrumbs for custom CSS targeting
• Fixed stretched open-graph images by analyzing dimensions to maintain proportions at 56px height
• Corrected VSCode to VS Code in contextual menu when enabled
• Fixed headings within custom components appearing in table of contents alongside semantic headings

​

Bug fixes and reliability

• Fixed PDF render issues with certain page titles by sanitizing characters that cause generation problems
• Resolved CLI error Cannot convert undefined or null to object when encountering empty OpenAPI JSON files
• Fixed custom docs.json open-graph metatags being overwritten by generated ones
• Fixed RSS feed button clicks when landing on anchor links by using origin + pathname for RSS links
• Improved CLI download speed by removing sourcemaps

​

Technical improvements

• Added visual tests to CI pipeline for earlier regression detection
• Enhanced error handling and debugging capabilities
• Comprehensive testing coverage for new features and edge cases

​

Authentication improvements

• Group-level public access: make entire page groups public via docs.json so you don’t need public: true on each page (learn more)
• Support logoutURL in OAuth configuration to delete upstream cookies and complete sign-out
• On OAuth errors, users are redirected to your specified logoutURL to restart the auth flow
• Fixed a flash of a 500 error during OAuth/JWT flows before the callback
• Auto-strip https:// from URLs in OAuth/JWT auth configuration to prevent misconfiguration

​

API playground enhancements

• New Search API endpoint so you can build agents and MCP servers on top of your docs
• openapi and asyncapi files are now served at their specified paths (e.g. https://mydocsurl.extension/{openapi-or-file-name}.json)
• You can now use the x-mint field in your openapi files to override generated fields, customize preface content, or change endpoint URLs in code samples
• x-mcp is now x-mint.mcp in OpenAPI configurations to control which routes are exposed as MCP tools

​

Assistant updates

• Fixed an issue where the action menu (containing options like copy and thumbs up) for older messages disappeared when new ones streamed in
• Fixed accessibility of nested /mcp/... pages after the hosted MCP servers release from last week

​

Performance and reliability

• All image and video assets present in your docs repo are now served at the appropriate path on your domain. For example, if you have /assets/marketing/my-logo.png in your repo, it will be available at https://mydocsurl.extension/assets/marketing/my-logo.png.
• Email field on login for the Mintlify dashboard now autofocuses so you can start typing immediately (quality of life improvement)
• Both custom domains and subdomains in Redis for a performance improvement on navigation load times (~50ms latency reduction)
• Added retry logic for PDF exports to improve reliability
• Fixed cookie consent popup reappearing after acceptance or dismissal—first selection is now respected
• Fixed copying a page to clipboard on Safari by specifying a MIME type in navigator.write

​

Technical improvements

• CLI bugfixes for windows and pnpm, plus CI tests to prevent regressions
• Improved error logging output—a quality of life upgrade for our engineering team when debugging
• Minor fixes to the broken-link CI action when contentDirectory files are missing
• Fixed a regression caused by the auth-protected preview fixes from last week where the active tab was not being set correctly in the navigation UI
• Fixed theme light background color not being applied to active tab icons
• Fixed an issue where changing the auth type in the dashboard would update and then flip back to the previously saved type—now the new selection persists after saving
• Internal DX improvements for enterprise customers with custom UI libraries—it’s now easier for us to include your components and accommodate requests on shorter timelines

​

Authentication improvements

• Local development improvements to auth, enabling faster development of auth features and bug fixes in this product area
• Preview deployments now available for auth-protected sites
• Fixed redirect behavior to properly return users to their original page after authentication
• Fixed logout button display for full authentication (previously only worked for partial authentication)

​

API playground enhancements

• Fixed multipart/form-data file upload functionality in the API playground
• Fixed anchor link behavior so clicking them updates the URL without scrolling to top of page
• Fixed anchor link issues in nested tabs

​

Assistant updates

• New Assistant API so you can build it into your own products, compatible with AI SDK
• Added copy button to chat responses
• Fixed issue with retrying messages in the assistant
• Improvements to default assistant prompt to make it less verbose by default

​

Performance and reliability

• Made search feel more crisp and accurate by aborting debounced requests as you type
• Resource provisions for a new CDN - expect image asset and page load times to improve soon
• Fixed bugs for rendering complex Mermaid diagrams like GANTT charts
• Fixed CLI bugs on Windows to improve stability and added tests to prevent regression

​

Technical improvements

• Added OpenTelemetry for traces in NextJS application to improve time to first byte for customers
• Migrated from Octokit to GitHub API Client to improve latency in the web editor experience
• Fixed duplicate meta tags for OpenGraph
• Upgraded MongoDB from version 6 to 7 for improved performance and new features

​

Slack app

• Zero friction access: Bot responds to DMs, @mentions, and any question in your #ask-ai channel
• One-click setup: Install directly from your Mintlify dashboard in seconds
• Contextual answers: Searches your entire documentation to provide relevant, accurate responses
• Deflect support interruptions: Turn daily questions into instant, self-serve answers

​

Hosted MCP servers

​

Code block improvements

• Improved syntax highlighting
• Added more customization options including focus mode, expandable code blocks, dark and light mode responsiveness, language dropdown menu, line numbering, and icons

​

AI assistant updates

• Improved accuracy through agentic RAG with tool calling
• Provides navigable links to referenced pages so that users can go directly to the source of answers
• Copy shortcut for code examples generated by assistant
• “Ask AI” shortcut on code blocks in documentation to generate explanations from the assistant

​

Subscribable changelogs

• Automatically generate an RSS feed from changelog pages
• Integrate RSS-enabled updates with Slack, email, and other tools

​

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

​

mint update

​

Web Editor 3.0

• Search for file names using ⌘ + P shortcut
• Pages load 10x faster
• Faster load times when searching for a branch
• Page options tab to configure layout, title, & metadata for SEO
• Floating toolbar when you highlight text

• Fixed top margin for changelog components
• Improved reliability of right click behavior
• After clicking publish, you’ll stay on the same page instead of being brought to an empty state
• Standardized colors in file icons
• Improved reliability after selecting new branches several times in a row
• Removed Diff mode
• More consistency when creating a new folder from the dropdown
• Fixed block quotes creating more block quotes when trying to deselect

​

AI Translations in beta

​

Export docs to PDF in beta

​

React hook support

​

MCP server generator

​

Improvements

• Tag changelog updates so end users can filter updates
• Sonnet-3.7 supported for AI Chat. Configure your preferred model through the dashboard
• Change your deployment name directly in dashboard settings

​

Bug fixes

• OG images fixed
• Fixed icon style inconsistency for anchors without container
• Improved styling nits for dashboard border for mobile-tablet-desktop responsiveness
• Show code examples even when in simple mode for API playground
• Support “command + k” shortcut for search in web editor
• Codeblocks within callouts expand to fill the width of the callout area

​

New configuration schema docs.json

1. Make sure your CLI is the latest version

npm i mint@latest -g

1. In your docs repository, run

mint upgrade

1. Delete your old mint.json file and push your changes

​

CI Checks

​

.md support for LLMs

​

More Themes

• Maple
• Palm
• Willow

​

Other improvements

• Guide to Technical Writing:Best practices for writing technical documentation, including audience research, content types, and writing tips.
• Dropdown component: Organize navigation with a dropdown, in addition to tabs and anchors.
• AI syntax fixer: The web editor will catch if there’s a parsing error and use AI to suggest fixes.

​

AI Assistant Improvements

• New UI with dedicated chat page & pre-filled prompts
• Stability improvements, e.g. bug fixes of editing the wrong file or no files at all
• More robust knowledge for adding & editing components
• Improved docs.json file editing

​

Partial Authentication

​

Revamped API Playground

• Easier detail expansion for an overview of a field
• More intuitive nested design, e.g. adding or deleting items
• Faster response times

​

Quality Improvements

• Support for requiring authentication to access preview deployments

​

Authentication

​

AI Writer

​

GitLab Integration Upgrade

​

Web Editor

​

/llms.txt support

​

Localization

​

Quality Improvements

• Return chat & search results based on the current version that the user is reading
• Authenticate users with OAuth, in addition to JWT or Shared Session tokens.

​

Changelogs

​

Code Line Highlighting

const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();

```javascript Line Highlighting Example {1,3-5}
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```

​

Light mode code blocks

"codeBlock": {
  "mode": "auto"
}

​

Advanced Footer

​

Filter search based on the current user

​

Custom Prompts for AI Chat

​

Dashboard Improvements

• Added ability to change custom domain to be /docs directly through dashboard settings.
• Consolidated the login and signup pages to decrease friction and confusion.
• Implemented the discovery login flow so that users that are members of multiple organizations can now switch between them.
• Added login with Google OAuth
• Added ability to add new deployment through dashboard settings.

​

Bug Fixes

• Can now use leading slashes in navigation.
• Can now edit CSS & JS files in the web editor.
• Fixed suggestEdit not showing up even when enabled.
• Fixed keyboard navigation for Search and Chat such that you can now use the up and down arrow keys to navigate the results.
• Don’t allow search engines to crawl user-auth protected pages.
• Revalidate the cache when an org is deleted.
• We now use the Scalar OpenAPI parser to parse OpenAPI definitions which improves the performance, fixes parsing issues, and surfaces better error messages.
• Top-level descriptions are now supported in API reference pages autogenerated from OpenAPI definitions.
• Add in-line-style support for icons
• Fixed the pop-in of custom CSS in docs.
• Properly show in-line code styling in conjunction with links.
• Maintain scroll position when you click the back button in a browser.

​

Custom Fonts

​

Images in Card components

​

Update Speed Performances

​

SEO improvements

​

Dashboard Improvements

• App router migration in the dashboard.
• Search analytics are now available in the dashboard.
• Delete an org functionality has been added to the dashboard.
• Shipped GitLab connection UI.
• Fix incorrect analytics data.
• Add-on’s can now be directly purchased through the dashboard.

​

Bug Fixes

• Fixed a bug where the top bar would not stretch to the width of the screen when it’s in custom mode and the sidebar layout is sidenav.
• Fix relative positioning of the AI widget.

​

More

• Troubleshooting for API pages: API pages could be complicated so we listed common issues to help you sort them out quickly — Read the docs

​

OpenAPI Reference Pages

• Endpoints defined by OpenAPI that are complex and recursive are now 98% smaller.
• We now show additionalProperties in OpenAPI pages.

​

File Uploads in API Playground

• Learn more about API configurations

​

Mobile SEO improvements

​

Support Form

​

Bug Fixes

• Fixed a bug for the Segment integration functionality.
• We now raise more granular error messages for GitHub permissions when interacting with the editor.
• Fixed bugs where the navigation would not properly expand when a direct link was used.

​

AI Widget

• Read the blog announcement

​

Pro Plan

• Read the blog announcement

​

API Playground Code Example Sync

​

Insights

​

Launch Week Highlights

• Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your docs.json file and it’ll update your docs styling.
• Search V2: directly query OpenAPI endpoint descriptions and titles to reach API Reference pages, remove hidden pages from search, and enjoy our updated search bar UI.
• Web Editor branching: create branches in our web editor without an IDE.
• User Personalization: authenticate users with Shared Session or JWT so that you can show them customized content, such as pre-filling API keys or showing specific content for customers.
• OpenAPI Automation Upgrades: to auto-populate API Playground pages, you can add an openapi field to an object in tabs or anchors arrays in the docs.json.

​

Okta SSO

​

Mintlify REST API

​

Custom mode

• Create a custom global landing page setup with custom components
• Add full-screen videos or image galleries
• Embed custom iFrame demo elements to add intractability to your docs

​

Mintlify MDX for VSCode

​

Quality Improvements

• Dashboard upgrades: view update logs to see what’s changed and status of an update, toggle between Mintlify projects to manage deployments
• Versioning with tabs fully supported
• Wildcard redirects now supported
• CLI Error Detection: we now show the position of invalid frontmatter when there are parsing issues during local development

​

Launch Week Highlights

• Preview Deployments: When you create a pull request, we’ll generate a unique link that shows a live preview of what your docs look like in prod. You can share this link with teammates.
• 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 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.