| title | Product updates |
|---|---|
| description | New releases and improvements |
| rss | true |
| noindex | true |
<Update label="August 24 - August 30" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Enhanced feedback collection, navigation improvements, and authentication bug fixes" }}>
- 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.
- 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
noAnchorattribute to yourh1-6HTML 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
drilldownwhich 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
- 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
*.mdfiles because they were missing ax-robots-tag noindexheader - 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
- 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 improvement by moving the KaTeX CSS from cdnjs to our own CDN on Cloudfront for reduced latency
<Update label="August 17 - August 23" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Image layout fixes, auth enhancements, mobile nav improvements, and web editor stability" }}>
- 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
- 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
- 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
- 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
- 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
<Update label="August 10 - August 16" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Performance optimizations, LLM integrations, web editor polish, and API playground enhancements" }}>
- 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
navigationdata in each page'srscpayload—performance gains most noticeable with high page counts or complex navigation structures - More aggressive prefetching enables instant page loads more frequently
- 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
webhookpages 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
- 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+Klink shortcut in monorepo dashboard Editor that was prepending docs repo path and creating broken links
- Custom
llms.txtandllms-full.txtsupport—add to docs repo root to serve at/llms.txtand/llms-full.txtendpoints for LLM customization - Added Hightouch analytics integration
- Enhanced context menu analytics tracking (dashboard viewing coming soon)
- Added e2e tests for
llms.txtandllms-full.txtto ensure correct serving
- Support for custom classnames in
h{1-4}tags for applying custom heading styles - Fixed
h{1-4}tags rendering asHeadingcomponents 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
VSCodetoVS Codein contextual menu when enabled - Fixed headings within custom components appearing in table of contents alongside semantic headings
- Fixed PDF render issues with certain page titles by sanitizing characters that cause generation problems
- Resolved CLI error
Cannot convert undefined or null to objectwhen encountering empty OpenAPI JSON files - Fixed custom
docs.jsonopen-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
- 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
<Update label="August 3 - August 9" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Search API, OAuth polish, asset serving, and MCP tooling" }}>
- Group-level public access: make entire page groups public via
docs.jsonso you don’t needpublic: trueon each page (learn more) - Support
logoutURLin OAuth configuration to delete upstream cookies and complete sign-out - On OAuth errors, users are redirected to your specified
logoutURLto 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
- New Search API endpoint so you can build agents and MCP servers on top of your docs
openapiandasyncapifiles are now served at their specified paths (e.g.https://mydocsurl.extension/{openapi-or-file-name}.json)- You can now use the
x-mintfield in your openapi files to override generated fields, customize preface content, or change endpoint URLs in code samples x-mcpis nowx-mint.mcpin OpenAPI configurations to control which routes are exposed as MCP tools
- 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
- 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.pngin your repo, it will be available athttps://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
typeinnavigator.write
- 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
contentDirectoryfiles 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
<Update label="July 27 - August 2" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Authentication improvements, search enhancements, and assistant API" }}>
- 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)
- Fixed
multipart/form-datafile 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
- 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
- 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
- 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
<Update label="July 2025" tags={["New releases", "Improvements"]} rss={{ title: "July Product Updates", description: "Slack app integration, hosted MCP servers, Cursor integration, and performance improvements" }}>
- Zero friction access: Bot responds to DMs, @mentions, and any question in your
#ask-aichannel - 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
Learn more in our Slack app guide.
Deploy hosted Model Context Protocol (MCP) servers directly through Mintlify to integrate with AI tool like Claude, Cursor, and others. Learn more in our MCP guide.
Help users quickly connect your MCP server to Cursor or VS Code from any page in your docs via the contextual menu. See Contextual menu for more information.
- 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
<Update label="June 2025" tags={["New releases", "Improvements"]} rss={{ title: "June Product Updates", description: "AI assistant updates and subscribable changelogs" }}>
- 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
Learn more in the assistant docs.
- Automatically generate an RSS feed from changelog pages
- Integrate RSS-enabled updates with Slack, email, and other tools
Learn more in our new Changelog guide
<Update label="May 2025" tags={["Improvements"]}>
- 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.
Can now use mint update to update your CLI.
<Update label="April 2025" tags={["New releases", "Improvements"]}>
 Overhauled usability in the WYSIWYG editor.Major improvements
- 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
Additional fixes
- 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
Export all of your documentation, a subdirectory, or a singe page as a PDF.
Bring interactivity to your docs. All standard React hooks are automatically available in your MDX files. Learn more.
<Update label="March 2025" tags={["New releases", "Improvements"]}>
 Generate MCP servers so that AI applications can interact with your docs or APIs. Written content is automatically generated as an MCP server, and you can generate an MCP server from your OpenAPI spec with one click. Check out [docs on getting started with MCP.](/ai/model-context-protocol)- 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
- 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
<Update label="February 2025" tags={["New releases", "Improvements"]}>
 We've introduced a new `docs.json` schema as a replacement for `mint.json`, to support better multi-level versioning, easier visual comprehension, and more consistent terminology. For more information on what's changed, [check out our blog](https://mintlify.com/blog/refactoring-mint-json-into-docs-json).Upgrade from mint.json to docs.json with the following steps:
- Make sure your CLI is the latest version
npm i mint@latest -g- In your docs repository, run
mint upgrade- Delete your old
mint.jsonfile and push your changes
Automatically lint your docs to find broken links, discover spelling and grammar issues, or enforce writing styles with your own Vale config. Learn more in our docs.
All documentation pages are now automatically available as plain Markdown files—just append .md to the URL. This makes it easier for LLMs to ingest individual pages from your documentation.
Now available:
- Maple
- Palm
- Willow
- 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.
<Update label="January 2025" tags={["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.jsonfile editing
Customize access to any page or section of content depending on user permissions. Supports connecting with your own authentication system.
We’ve overhauled the design and performance of the API Playground. Updates include:
- Easier detail expansion for an overview of a field
- More intuitive nested design, e.g. adding or deleting items
- Faster response times
- Support for requiring authentication to access preview deployments
We've improved our support for syncing with GitLab, such as enabling automated updates and preview deployments. Check out our docs on GitLab to get started.
 We've revamped our web editor so that you can now update docs with a fully WYSIWYG experience, while syncing with markdown.Check out our docs on getting started with Web Editor.
 All docs instances are now automatically hosted at /llms.txt and /llms-full.txt so that LLMs can easily ingest your documentation. For more information, read the [docs on the new llms.txt standard.](https://llmstxt.org)You can now localize your docs which operates similarly to versioning. Add a locale to a version and fixed content in Mintlify like "Was this page helpful?" will also match the locale.
- 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.
Launched a new Update component to make it easier to display and report updates (like this one) to your users.
 ## Code Line HighlightingYou can now highlight lines of code in your docs to emphasize and bring attention to important parts by adding a special comment after the language identifier. Use curly braces {} and specify line numbers or ranges separated by commas.
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();
```Code blocks now have a light mode variant which can be enabled by adding the following to your docs.json:
"codeBlock": {
"mode": "auto"
}When personalization is enabled, search results are now filtered based on the current logged in user so that they only see the relevant content.
You can now customize the prompts for the AI chat. Please reach out to support if you'd like to customize the prompts.
- 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.
- Can now use leading slashes in navigation.
- Can now edit CSS & JS files in the web editor.
- Fixed
suggestEditnot 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.
Add an img property to a card to display an image on the top of the card. Learn more about it here.
- 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.
- 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.
- Troubleshooting for API pages: API pages could be complicated so we listed common issues to help you sort them out quickly — Read the docs
- Endpoints defined by OpenAPI that are complex and recursive are now 98% smaller.
- We now show additionalProperties in OpenAPI pages.
By default, API playground requests are proxied by Mintlify. Now you can use
disableProxy to disable this behavior and support request types like file
uploads.
We've fixed the mobile layout of our docs so that they are more SEO-friendly - including adding proper aria tags to elements.
We added a more detailed support form to the Mintlify dashboard. You can now submit a form to get in touch with us.
- 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.
We also updated our pricing plans for better customizability and scale.
When you browse API docs, the selected code example now syncs across your pages.
Currently in beta, this feature summarizes common user questions and patterns into easy-to-digest reports with AI-powered suggestions on how to improve your product.
## Launch Week Highlights- Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your
docs.jsonfile 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
openapifield to an object in tabs or anchors arrays in thedocs.json.
We now support sign-on via Okta SAML and OIDC.
Programmatically rigger updates to your documentation.
## Custom modeAdd a configuration to the metadata to remove all elements except for the top bar. Example use cases:
- 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
Check out our Custom Mode docs.
## Mintlify MDX for VSCodeCall snippets of our pre-built components and callouts without leaving VSCode. Install the extension here.
## 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
- 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.