Product updates - Mintlify

Documentation Index

Fetch the complete documentation index at: /docs/llms.txt

Use this file to discover all available pages before exploring further.

Skip to main content

​

September 11, 2026

New releasesImprovementsBug fixes

​ AI credit pricing updates

​ OpenAPI Overlays

​ Editor and collaboration

​ Automations

​ Published sites

​ Dashboard

​ Git and integrations

​ API playground

​ Bug fixes

​

September 4, 2026

New releasesImprovementsBug fixes

​ Notification preferences

​ Editor and collaboration

​ Automations

​ Analytics

​ API playground

​ Authoring

​ Referrals

​ Bug fixes

​

August 28, 2026

New releasesImprovementsBug fixes

​ Referral program

​ Authoring

​ Editor and collaboration

​ Automations

​ Analytics

​ Docs and agents

​ Bug fixes

​

August 21, 2026

New releasesImprovementsBug fixes

​ Editor and collaboration

​ Automations and integrations

​ Docs and delivery

​ Bug fixes

​

August 14, 2026

New releasesImprovementsBug fixes

​ Bitbucket Cloud support

Bitbucket Cloud is now supported as a Git provider for Enterprise plans. See Bitbucket Cloud support for more information.

​ Editor and collaboration

​ Docs and delivery

​ Agent integrations

​ Bug fixes

​

August 7, 2026

New releasesImprovementsBug fixes

​ New features

​ Improvements

​ Bug fixes

​

August 5, 2026

New releases

​ Mintlify Index

Mintlify Index gives coding agents one retrieval layer for publisher-maintained technical documentation and the web.

​

July 31, 2026

New releasesImprovementsBug fixes

​ Mintlify widget

Embed the assistant on any site or web app to give your users the same AI-powered chat experience trained on your content. See the widget documentation for more information. The widget can surface contact forms and hand off to your support team.

​ New features

​ Improvements

​ Bug fixes

​

July 24, 2026

New releasesImprovementsBug fixes

​ GraphQL and SDK references

​ Editor and collaboration

​ Automations, integrations, and Slack

​ Analytics and data streaming

​ Sites, deployments, and performance

​ Bug fixes

​

July 16, 2026

New releasesImprovementsBug fixes

​ Page improvements

​ Editor improvements

​ Sites and dashboard

​ Automations and Slack agent

​ Analytics

​ Bug fixes

​

July 10, 2026

New releasesImprovementsBug fixes

​ Custom domain, subdomain, and subpath hosting

​ Editor comments, suggestions, and performance

​ Search filters and ranking

​ Enterprise security and access control

​ Assistant and automations

​ Other improvements

​ Bug fixes

​

July 2, 2026

New releasesImprovementsBug fixes

​ Assistant skills and support handoff

​ Enterprise security

​ Improvements

​ Bug fixes

​

June 26, 2026

New releasesImprovementsBug fixes

​ New releases

​ Improvements

​ Bug fixes

​

June 19, 2026

New releasesImprovementsBug fixes

​ New releases

​ Improvements

​ Bug fixes

​

June 12, 2026

New releasesImprovementsBug fixes

​ Authenticated sites on Starter plan

​ Editor improvements

​ Search and AI

​ Bug fixes

​

June 5, 2026

New releasesImprovementsBug fixes

​ Agent and automation integrations

​ Slack agent

​ Search

​ Improvements

​ Bug fixes

​

May 29, 2026

New releasesImprovementsBug fixes

​ Editor

More ways to edit and configure your docs directly from the web editor:

​ Editor agent

​ Automations

​ API playground

​ Admin MCP

Agents that connect to the admin MCP can now read and modify most dashboard settings directly. This lets you configure your entire Mintlify setup without touching the dashboard and gives AI agents direct access to your analytics data. Supported operations include:

​ Agent discoverability

​ Improvements

​ Bug fixes

​

May 22, 2026

New releasesImprovements

​ Web Editor

We’ve continued to enhance our web editor with a number of functionality and UI improvements.

​ Automations

​ Search Improvements

​ Improvements

​

May 15, 2026

New releasesImprovements

​ Web Editor

The editor has been redesigned for live collaboration, parsing, and stability. Additional improvements include:

​ Improvements

​ Bug fixes

​

May 8, 2026

New releasesImprovements

​ Expanded MCP content access

Authenticated MCP servers now return more of your content to authorized users. Authenticated users can search public pages plus any pages they have permission to access based on their user groups, instead of being limited to public pages only. Client credentials return all public pages and authenticated pages that aren’t restricted to specific groups.The Mintlify MCP list_nodes tool now supports filtering by parentId (with optional recursive traversal), multiple node types, and additional division scopes including dropdown, anchor, product, and item. Results are paginated through an opaque cursor. See the Mintlify MCP documentation for more details.

​ Assistant credit packages

The assistant billing experience has been updated to use credit-based packages across all plans, with consistent terminology in the dashboard and usage controls. No changes to existing credit balances or usage.

​ AsyncAPI nested groups

The asyncapi property now supports nested groups, so you can generate channel pages inside a subsection of a broader API group or combine multiple AsyncAPI specifications under a shared parent.

​ Improvements

​

May 1, 2026

New releasesImprovements

​ Automations

Automations have been rebuilt with a new dashboard experience.

See the automations documentation for more details.

​ Editor

The editor is redesigned for better collaboration and improved stability. The editor now supports real-time collaboration, automatic saving across devices, and improved syncing.See the editor documentation for more details.The classic editor sunsets in May 2026.

​ Agent score

Agent score evaluates how agent-ready your site is. It is a free tool built on the open source AFDocs spec with additional checks based on Mintlify’s research and best practices.

​ Mintlify MCP

The Mintlify MCP server lets you directly update your content and site with your preferred AI tools. Connect any MCP client like Claude, Claude Code, or Cursor to the Mintlify MCP to collaborate on your Mintlify content with the same tools you use to write code. When you use the MCP server, all changes happen on a branch and require a pull request to merge.See the Mintlify MCP documentation for more details.

​ Agent connections

Ask the agent in Slack to set up any third-party integration that it should use as context. Prompt the agent to connect to a service like GitHub, Jira, Notion, Google Drive, Confluence, or any other service that you use.The agent uses Composio to support a broad catalog of third-party services, including issue trackers, knowledge bases, CRMs, and developer tools. See the Composio toolkits catalog for the full list of supported services.

​ Section-level search boost

Search indexing now supports section-level boosts and page-level boosts, letting you promote specific content so it ranks higher for relevant queries. See the Search documentation for more details.

​ Improvements

​ Bug fixes

​

April 24, 2026

New releasesImprovements

​ Preview Deployment API

A public API for generating preview deployments is now available. Use it to trigger previews from your own tooling—useful when your Git workflow doesn’t map cleanly to standard branch-based preview triggers. See Trigger preview deployment for more details.

​ Git onboarding and settings redesign

The Git settings page has been redesigned with a new layout. Mintlify-hosted customers migrating to their own GitHub or GitLab repository now get a step-by-step flow that walks through the full migration process.

​ Web editor improvements

The web editor now shows the full Git diff for the current branch, including changes already pushed. Review everything modified in one place before publishing or opening a pull request.Changes now persist locally, so edits made while offline are preserved and synced automatically when your connection returns.

​ Redirect destination checks

The mint broken-links command now supports an option to validate redirect destinations. Catch redirects that point to missing pages before they reach production.

​ Improvements

​ Bug fixes

​

April 17, 2026

New releasesImprovements

​ Visibility component

The new Visibility component lets you show different content to human readers and AI agents on the same page. Wrap content in <Visibility for="humans"> to display it only on the web version of a page or <Visibility for="agents"> to include it only in Markdown output consumed by AI tools. Useful for tailoring instructions, examples, or formatting to each audience without maintaining separate pages.

​ Agent feedback

Enable agent feedback in your deployment settings to let agents submit structured feedback about your documentation. When turned on, Markdown versions of your pages include feedback instructions so agents know how to report any issues they encounter accessing your documentation. Available as a beta feature in the dashboard under deployment add-ons.

​ MCP filesystem access

MCP servers now include a query docs filesystem tool that lets agents browse and read your documentation’s file structure directly. Agents can navigate directories, read full page content, and batch-read multiple pages in a single call. This tool replaces the get_page tool.

​ Git setup wizard

A new step-by-step wizard on the Git settings page guides you through connecting a GitHub or GitLab repository for the first time. Choose between one-click cloning or manual repository selection, with support for organization selection, branch configuration, and subdirectory setup.

​ GitLab OAuth for automations

Automations now support GitLab repositories through OAuth authentication. Connect your GitLab account from the dashboard to use GitLab repos as documentation sources, trigger repositories, or context repositories in your automations. The agent opens merge requests on GitLab just like it opens pull requests on GitHub.

​ Improvements

​ Deprecations

​ Bug fixes

​

April 10, 2026

New releasesImprovements

​ CLI analytics

The mint analytics command lets you view traffic, search queries, user feedback, and assistant conversations from the terminal for better integration with agents.Use subcommands to explore specific data:

All subcommands support --from, --to, and --format flags. Output formats include plain (default), table, json, and graph.

​ Directory listings

Navigation groups with a root page can now display a directory listing of their child pages. Set the directory property on a group, tab, or the top-level navigation object to "accordion" or "card" to automatically generate an overview of the section’s content. Useful for help centers and other sites where users need a quick way to browse all available pages in a section.

​ Multi-skill support

Serve multiple skill files from a .mintlify/skills/ directory. Each subdirectory with a SKILL.md file is discovered and served automatically, so you can organize skills by feature or domain.

​ Slack agent improvements

​ Client credentials for authenticated MCP

Client credentials are now available for authenticated MCP servers. Use client credentials to connect programmatically without a browser-based login—ideal for server-side integrations, CI/CD pipelines, and automated workflows. Create and manage credentials from the MCP server page in your dashboard.

​ Improvements

​ Bug fixes

​

April 3, 2026

New releasesImprovements

​ get_page MCP tool

MCP servers that Mintlify generates now include a get_page tool that lets AI agents fetch full page content by path. Agents can retrieve complete documentation pages for deeper context beyond search results.

​ Password-protected preview links

Preview deployments now support password-protection. Share preview links without exposing content publicly.

​ SAML group role mappings

Organizations using SAML SSO can now map SAML groups to dashboard roles for automatic role assignment when team members sign in.

​ Improvements

​ Bug fixes

​

March 27, 2026

New releasesImprovements

​ Linear integration

Connect your Linear workspace from the agent settings page to give the agent access to your Linear issues. The agent can reference issues and comments as context when generating documentation updates or you can delegate issues to the agent directly in your Linear workspace.

​ Notion integration

Connect your Notion workspace from the agent settings page to give the agent read access to your Notion content. The agent can reference Notion pages as context when generating documentation updates.

​ Offline export

Package your entire documentation site into a self-contained zip archive with the mint export CLI command. Share the zip so your users can view your docs in their browser without an internet connection or a Mintlify account.

​ Inline AI editing

Use inline AI editing to generate, rewrite, and restructure content directly in the visual editor. Select text and choose from preset actions or type a custom instruction. Changes stream in as a highlighted diff so you can review before applying.

​ Composable docs.json

Split large configurations into smaller files using $ref references. Each $ref points to a separate JSON file resolved at build time.

​ data-active CSS selectors

Sidebar items, table of contents entries, and navigation dropdowns now expose a stable data-active attribute for custom CSS targeting. Use selectors like .toc-item[data-active] or #sidebar-content li[data-active] to style active states without relying on internal class names.

​ Agent-skills discovery endpoint

Documentation sites now serve a /.well-known/agent-skills/ discovery endpoint following the agent-skills 0.2.0 spec. AI agents can programmatically discover and fetch your skill files with content integrity verification.

​ API playground credentials

A new api.playground.credentials option sends browser-managed credentials (like cookies and session tokens) with API playground requests when the proxy is disabled. Useful for APIs that use cookie-based authentication.

​ Improvements

​ Bug fixes

​

March 20, 2026

New releasesImprovements

​ Authenticated MCP route

A new authenticated route is available for MCP servers, enabling secure search over documentation sites with authentication enabled.

​ New contextual menu options

The contextual menu now includes options for Google AI Studio, Devin, and Windsurf. Users can open any documentation page directly in these tools with the page content preloaded as context.

​ Self-hosted GitLab configuration

You can now configure self-hosted GitLab instances directly from the dashboard. GitLab API requests are proxied through the server, removing the need for browser-based authentication to your GitLab instance.

​ Invite multiple members

Invite multiple team members to your organization at once from the dashboard instead of sending invitations one at a time.

​ Improvements

​ Bug fixes

​

March 13, 2026

New releasesImprovements

​ Automation templates

Create automations faster with pre-built templates in the dashboard. Choose from templates for changelog generation, API docs sync, feature documentation drafts, broken link detection, SEO audits, and more. Templates include optimized prompts and trigger configurations to get you started quickly.

​ Automation CLI command

Create automations files from the command line with the mint automation CLI command. Interactive prompts guide you through name, trigger, context, and instructions.

​ Agent API v2

Trigger the agent programmatically with the new /v2/agent endpoints. Submit a job with a prompt and optional context, then poll for completion status and the resulting pull request link. Useful for integrating agent-driven documentation updates into your own CI/CD pipelines or internal tooling.

​ Additional language support

Added support for localization in Hungarian (Magyar) and Catalan.

​ Per-page feedback analytics

View feedback broken down by individual pages in your analytics dashboard.

​ Improvements

​ Bug fixes

​

March 6, 2026

New releasesImprovements

​ Auto-generate documentation from public repositories

Auto-generate a complete documentation site from any public GitHub repository. Replace github.com with mintlify.com in any public repository URL to instantly preview generated documentation. If you are the repository owner, claim the documentation site to add it to your Mintlify organization and customize it.

​ Assistant improvements

The assistant now supports multi-modal input. Attach files to messages to provide additional context. Drag and drop or paste images, PDFs, and code files directly into the chat.The assistant can now generate page-specific example questions.The assistant now also builds context from the page a user is on and indexes entire OpenAPI specifications.

​ Default Vale configuration updates

The default Vale configuration now parses MDX as MD to avoid fragility with JSX. Previously, Vale returned false positive errors on any JSX inside of MDX components. Now, Vale parses MDX as MD to avoid these errors with tokenIgnores and blockIgnores for MDX and JSX elements that Vale should skip.

​ Improvements

​ Bug fixes

​

February 27, 2026

New releasesImprovements

​ Automations

Automate documentation tasks with automations. Set up scheduled or event-triggered automations that run the agent to update your documentation.Automations are in beta and available on all plans.

​ Comments and suggestions

Collaborate directly in the web editor with comments and suggestions. Select text to leave feedback, mention teammates, or suggest changes.

​ Luma theme

New Luma theme available for a minimal, calm design.

​ Improvements

​ Bug fixes

​

February 20, 2026

New releasesImprovements

​ assistant.md and agent.md support

Use .mintlify/Assistant.md and .mintlify/AGENTS.md files in your repository to customize the agent and assistant behaviors. See Customize assistant behavior and Customize agent behavior for more information.

​ Custom frontend

Bring your own frontend and use the Mintlify content engine to publish your documentation and enable AI tools. See the custom frontend guide for more information.

​ Improvements

​ Bug fixes

​

February 13, 2026

New releasesImprovements

​ Prompt component

Use the prompt component to display copyable prompts. Designed for sharing AI prompts and supports opening prompts directly in Cursor.

​ Sequoia theme

The Sequoia theme features redesigned table of contents with the contextual menu in the sidebar.

​ Tabler icon support

You can now use Tabler icons throughout your documentation by setting "library": "tabler" in your docs.json icons configuration.

​ Add MCP in contextual menu

The contextual menu now includes an option to add a copyable command to install your docs MCP server.

​ root in groups

Navigation groups now support a root property to set a landing page for the group. Clicking the group header navigates to the root page instead of expanding the group.

​ Editor improvements

​ Feedback email capture

The feedback form now includes an optional email field so users can provide contact information when submitting feedback.

​

February 6, 2026

New releasesImprovements

​ Self-serve SSO configuration

Enterprise customers can now configure SAML SSO (Okta or Microsoft Entra) directly from the dashboard, including just-in-time (JIT) provisioning, provider switching, and connection removal.

​ Viewer role

New viewer role with read-only access to your dashboard. Viewers can see content in the editor, but they cannot edit content, invite members, or modify configurations.

​ Human/AI traffic toggle

The analytics page now shows separate human and AI traffic tabs.

​ Slash command menu redesign

The editor slash menu now features type-to-search, improved keyboard navigation, and other UX improvements.

​ Bug fixes

​

January 30, 2026

New releasesImprovements

​ Skills installation simplified

Install skill.md files using just a documentation URL. No path to the skill.md file needed.

npx skills add mintlify.com/docs

​ Revamped analytics page

Improved navigation between analytics tabs. More actionable insights and better data visualization.

​ Editor improvements

​ Updated assistant page

Manage all assistant features in one page with a cleaner layout and better UX.

​ MCP filtering

AI agents can now filter MCP search results by parameters.

​ Other

​ Bug fixes

​

January 23, 2026

New releasesImprovements

​ skill.md auto-generation

Documentation sites now auto-generate a skill.md file based on your API references, guides, and features to give AI agents a comprehensive skills file with context on how to help people use your product. skill.md replaces the install.md approach with more structured capabilities and wider adoption. If you have a custom skills.md file at the root of your documentation repository, it replaces the auto-generated version. See skill.md for more information.

​ Audit logs for authentication events

Events are now tracked in audit logs for visibility and compliance.

​ Markdown export for agents

Documentation pages now serve raw markdown when the Accept: text/markdown header is sent, which enables better AI agent consumption of content.

​ Improvements

​

January 16, 2026

New releasesImprovements

​ install.md auto-generation

Documentation sites now auto-generate an install.md file that aggregates installation-related pages like quickstarts, getting started, installation, and setup guides for AI agents. If you have a custom install.md file in your documentation repository, it takes priority over the auto-generated version.

​ Web editor improvements

​ Branch search for Git integrations

Added branch search functionality for GitHub and GitLab integrations so that it is easier to find and switch between deployment branches in the Git settings of your dashboard.

​ mintlify validate CLI command

New CLI command to validate your documentation builds locally before deploying. Run mint validate to catch configuration and build errors early.

​ Assistant message tiers

Users can now select tiers of assistant message allotments per month from the dashboard.

​ Bug fixes

​

January 9, 2026

New releasesImprovements

​ Implicit snippets

Snippets now work without explicit configuration. Previously, you needed to define snippets in a specific /snippets directory. Now, you can import any file as a snippet from anywhere in your docs for more flexible content reuse. See Reusable snippets for more information.

​ Assistant suggestions for all users

Conversation insights are now available for all documentation sites that have both the agent and assistant enabled. The agent analyzes patterns in assistant conversations to identify documentation gaps and suggest improvements, helping you proactively address common user questions.

​ Tab and code group synchronization

Tabs and code groups now synchronize their selection across the page. When you select a tab in one component, all other tab components with matching labels update to show the same selection. This keeps language or framework choices consistent throughout a page.

​ Improvements

​

December 23, 2025

New releasesImprovements

​ Web editor improvements

The web editor now has a more intuitive interface and new capabilities.

​ Agent suggestions from assistant conversations

The agent can now suggest documentation updates based on assistant conversations. When enabled, the agent analyzes questions users ask the assistant to identify patterns that indicate missing or unclear documentation.This adds a second source for agent suggestions alongside repository monitoring, helping you proactively address common user questions.

​ Slack bot customization

You can now customize your Slack bot directly from the dashboard.

​ Mobile navigation improvements

​ Bug fixes

​

December 19, 2025

Improvements

​ Agent improvements

​ Assistant improvements

​ Web editor improvements

​ Onboarding improvements

​ Snippet improvements

​ Localization improvements

​

December 12, 2025

New releasesImprovements

​ Agent suggestions

The agent can now monitor Git repositories and suggest documentation updates. When user-facing code changes are detected, suggestions appear in the agent panel. Suggestions include the relevant pull request and a list of proposed documentation updates. Add suggestions as context for the agent to create pull requests or dismiss them.

​ Q&A bot in Slack

Add a bot powered by the assistant to your Slack workspaces. The bot answers questions in real-time based on your documentation, so it provides accurate, up-to-date answers to your community.The bots respond to @ mentions and to every message in channels named #ask-ai.

​ Snippets now support relative imports

You can now use relative paths when importing snippets in your MDX files. Previously, imports required absolute paths starting with /snippets/. Now you can use relative paths like ../snippets/example.mdx for more flexible file organization.

​ Improvements

​ Bug fixes

​

December 9, 2025

New releases

​ Preview widget

Preview deployments now include an interactive widget that displays all changed files in the deployment. The widget appears as a floating button in the bottom-right corner and provides:

The widget is automatically enabled on all preview deployments and helps reviewers quickly navigate to modified content.

​

December 8, 2025

New releases

​ Last modified dates

You can now display “last modified” timestamps on all pages in your documentation. Enable this feature by setting the timestamp flag in your docs.json settings.When enabled, each page will automatically show when it was last updated, helping readers understand how current the content is.

​

December 5, 2025

Improvements

​ Web editor improvements

​ Assistant improvements

​ Bug fixes and reliability

​

December 3, 2025

New releases

​ Assistant query bucketing

Assistant insights now automatically groups similar queries together into question categories, which makes it easier to identify patterns in what your users are asking about.Click a category to see all conversations in the category and drill down into individual conversations where you can see user queries, assistant responses, and sources cited.

​

December 1, 2025

New releases

​ .mintignore support

Learn more in the .mintignore documentation.

​

November 25, 2025

Improvements

​ Vale version upgrade

​

November 21, 2025

Improvements

​ API playground improvements

​ Localization improvements

​ CLI improvements

​

November 15, 2025

New releasesImprovements

​ New features

​ API playground improvements

​ Navigation and UI enhancements

​ Web editor improvements

​ Component and styling enhancements

​ Performance and infrastructure

​ Bug fixes and reliability

​

October 31, 2025

Improvements

​ Assistant improvements

​ API playground improvements

​ Analytics changes

​ Visual improvements

​ Bug fixes

​

October 24, 2025

Improvements

​ Insights improvements

​ Assistant improvements

​ API playground and OpenAPI enhancements

​ Web editor and deployment enhancements

​ Performance and infrastructure

​ Bug fixes and reliability

​

October 17, 2025

Improvements

​ Assistant and AI improvements

​ Navigation and UI enhancements

​ API playground and OpenAPI improvements

​ Bug fixes and reliability

​

October 11, 2025

Improvements

​ Assistant and Agent AI features

​ Insights improvements

​ Web editor and dashboard improvements

​ API playground enhancements

​ Bug fixes and reliability

​ Component and styling

​

October 3, 2025

New releasesImprovements

​ New features

​ Accessibility improvements

​ Assistant and analytics enhancements

​ Bug fixes and reliability

​

September 26, 2025

Improvements

​ Language support expansion

​ UI and user experience improvements

​ Infrastructure and performance enhancements

​ Bug fixes and reliability

​

September 19, 2025

Improvements

​ Web editor and dashboard login improvements

​ Authentication improvements

​ Bug fixes and reliability

​

September 13, 2025

New releasesImprovements

​ Major releases

Note: Contact us to enable this feature for your site.

​ Assistant and MCP

​ Web editor and deployments

​ API playground and navigation

​ SEO and UI

​ Analytics and exports

​

August 30, 2025

Improvements

​ Major release: Enhanced feedback collection

Note: Contact us to enable this feature for your site.

​ Navigation and quality of life improvements

​ Bug fixes and reliability

​ Component and styling enhancements

​ Performance improvements

​

August 23, 2025

Improvements

​ Image handling improvements

​ Web editor and deployment enhancements

​ Authentication and navigation improvements

​ Component and styling fixes

​ Technical improvements and reliability

​

August 16, 2025

Improvements

​ Performance and build optimizations

​ API playground and OpenAPI enhancements

​ Web editor improvements

​ Analytics and LLM integrations

​ Component and styling enhancements

​ Bug fixes and reliability

​ Technical improvements

​

August 9, 2025

Improvements

​ Authentication improvements

​ API playground enhancements

​ Assistant updates

​ Performance and reliability

​ Technical improvements

​

August 2, 2025

Improvements

​ Authentication improvements

​ API playground enhancements

​ Assistant updates

​ Performance and reliability

​ Technical improvements

​

July 2025

New releasesImprovements

​ Slack app

Learn more in our Slack bot guide.

​ Hosted MCP servers

Deploy hosted Model Context Protocol (MCP) servers directly through Mintlify to integrate with AI tools 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.

​ Code block improvements

​

June 2025

New releasesImprovements

​ AI assistant updates

Learn more in the assistant docs.

​ Subscribable changelogs

Learn more in our new Changelog guide.

​

May 2025

Improvements

​ API playground stability updates

Learn more at API playground docs.

​ mint update

Can now use mint update to update your CLI.

​

April 2025

New releasesImprovements

​ Web Editor 3.0

Overhauled usability in the WYSIWYG editor.Major improvements

Additional fixes

​ AI Translations in beta

Translate all of your documentation with AI.

​ Export docs to PDF in beta

Export all of your documentation, a subdirectory, or a single page as a PDF.

​ React hook support

Bring interactivity to your docs. All standard React hooks are automatically available in your MDX files. Learn more.

​

March 2025

New releasesImprovements

​ MCP server generator

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.

​ Improvements

​ Bug fixes

​

February 2025

New releasesImprovements

​ New configuration schema docs.json

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.Upgrade from mint.json to docs.json with the following steps:

  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

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.

​ .md support for LLMs

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.

​ More Themes

New pre-built themes to modify the look & feel of your docs. Configure via your docs.json file.Now available:

​ Other improvements

​

January 2025

Improvements

​ AI Assistant Improvements

​ Partial Authentication

Customize access to any page or section of content depending on user permissions. Supports connecting with your own authentication system.

​ Revamped API Playground

We’ve overhauled the design and performance of the API Playground. Updates include:

​ Quality Improvements

​

December 2024

​ Authentication

Make docs private by setting up authentication via JWT, OAuth, or a universal password. With this privacy, you can create an internal knowledge base or prevent competitors from seeing your docs.

​

November 2024

​ 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 writer will propose changes by generating a pull request.

​ GitLab Integration Upgrade

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.

​ Web Editor

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.

​ /llms.txt support

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.

​ Localization

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.

​ Quality Improvements

​

October 2024

​ Changelogs

Launched a new Update component to make it easier to display and report updates (like this one) to your users.

​ Code Line Highlighting

You 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.

Line Highlighting Example

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

Code blocks now have a light mode variant which can be enabled by adding the following to your docs.json:

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

​ Advanced Footer

You can now add more links to the standard footer. This upgrade provides more consistency between landing pages and docs, or greater customization if you want to spotlight specific pages like socials or status logs.

​ Filter search based on the current user

When personalization is enabled, search results are now filtered based on the current logged in user so that they only see the relevant content.

​ Custom Prompts for AI Chat

You can now customize the prompts for the AI chat. Please reach out to support if you’d like to customize the prompts.

​ Dashboard Improvements

​ Bug Fixes

​

September 2024

​ Custom Fonts

Personalize the font of your docs to your own font hosted on a CDN or by choosing from Google fonts to match your docs with your brand.

​ Images in Card components

Add an img property to a card to display an image on the top of the card. Learn more about it here.

​ Update Speed Performances

For large projects (~3,000 files), the download step for docs updates is now ~440x faster - a 99.8% time reduction. Across the board, file downloads during updates are now ~5.5x faster - an 81.8% time reduction.

​ SEO improvements

We’ve fixed both the mobile and desktop layout of our docs so that they are more SEO-friendly - including adding proper aria tags to navbar and toggle elements.

​ Dashboard Improvements

​ Bug Fixes

​ More

​

August 2024

​ OpenAPI Reference Pages

​ File Uploads in API Playground

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.

​ Mobile SEO improvements

We’ve fixed the mobile layout of our docs so that they are more SEO-friendly - including adding proper aria tags to elements.

​ Support Form

We added a more detailed support form to the Mintlify dashboard. You can now submit a form to get in touch with us.

​ Bug Fixes

​

July 2024

​ AI Widget

We introduced Mintlify Widget, an extension of your docs to answer your users’ questions when and where they asked. You can add this AI-powered chatbot to any web page: your landing page, inside your product, or on your existing documentation pages.

​ API Playground Code Example Sync

When you browse API docs, the selected code example now syncs across your pages.

​ Insights

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.

​

June 2024

​ Launch Week Highlights

​

May 2024

​ Okta SSO

We now support sign-on via Okta SAML and OIDC.

​ Mintlify REST API

Programmatically trigger updates to your documentation.

​

April 2024

​ Custom mode

Add a configuration to the metadata to remove all elements except for the top bar. Example use cases:

Check out our Custom Mode docs.

​

March 2024

​ Mintlify MDX for VSCode

Call snippets of our pre-built components and callouts without leaving VSCode. Install the extension here.

​

February 2024

​ Quality Improvements

​

January 2024

​ Launch Week Highlights

Related topics

Update Create developer documentation Changelogs

Ctrl+I

FiltersClear

ImprovementsNew releasesBug fixes

Assistant

Responses are generated using AI and may contain mistakes.

Suggestions

What is an OpenAPI spec?How do I set a custom domain?What is the contextual menu?

We value your privacy

This site uses cookies to improve your browsing experience, analyze site traffic, and show personalized content.

Reject AllAccept All

Customize