Mintlify Docs

4-10-25

API Playground

WebSockets

Create WebSockets reference pages with AsyncAPI. Learn more in WebSockets docs.

4-8-25

AI Translations in beta

Translate all of your documentation with AI. See supported languages.

4-6-25

Export docs to PDF in beta

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

4-4-25

Allow users to input your docs into LLMs with a dropdown. Set up the contextual menu in docs.json.

4-2-25

More models for AI chat

Supported models include:

Sonnet-3.7
Gemini 2.5
Llama 4 Maverick
OpenAI GPT-4o

Configure your preferred model through the dashboard.

3-31-25

UI/UX

Quality improvements

Support bullets in cards
Support headings in components
Support anchors in components

3-29-25

UI/UXAPI Playground

Bug fixes

Set max height for table of contents to ensure scrollability
Webhooks grouped with endpoints instead of creating new “Webhook” grouping in API reference
First click on the tab buttons no longer scrolls the tab to the top of the page
Show invisible options for type dropdown in API playground
Show configuration status only when not on subdirectory
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

3-27-25

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.

3-24-25

Tailwind CSS support

Tailwind CSS now supported out of the box.

3-21-25

Quality improvements

Tag changelog updates so end users can filter updates
Sonnet-3.7 supported for AI Chat
Change your deployment name directly in dashboard settings
Prompt to confirm changes before switching branches in web editor

2-28-25

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:

Make sure your CLI is the latest version

npm i mintlify@latest -g

In your docs repository, run

mintlify upgrade

2-26-25

UI/UX

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.

More Themes

We’ve added more themes to choose from:

Ash
Breeze
Evergreen
Geyser
Palm
Willow

2-22-25

Web Editor

Web editor improvements

Includes bug fixes and quality of life improvements:

Accordions no longer have pointer cursor on the non-clickable body of the accordion, just the trigger
Fixed bug where clicking on a link in an accordion would not close the accordion
Fixed bug where clicking on a link in a dropdown would not close the dropdown
Fixed bug where clicking on a link in a tab would not close the tab
Fixed bug where clicking on a link in a modal would not close the modal
Fixed bug where clicking on a link in a sidebar would not close the sidebar
Add dropdowns for props with union types
Match image metadata editor to match new prop editor

2-10-25

API Playground

Revamped API Playground

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

Quality Improvements

Support for requiring authentication to access preview deployments

1-31-25

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.

1-29-25

AI Assistant

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.

1-27-25

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.

1-25-25

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.

1-24-25

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

1-22-25

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.

1-20-25

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.

1-15-25

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.

```js {1,3-4}
import { useState } from 'react'

export default function Counter() {
  const [count, setCount] = useState(0)
  return (
    <button onClick={() => setCount(count + 1)}>
      Clicked {count} times
    </button>
  )
}
```

1-13-25

UI/UX

Light mode code blocks

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

{
  "lightCodeTheme": true
}

1-11-25

UI/UX

We’ve added a new footer component that supports links, socials, and more. This provides more consistency between landing pages and docs, or greater customization if you want to spotlight specific pages like socials or status logs.

1-10-25

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.

1-8-25

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.

1-6-25

UI/UX

Dashboard Improvements

Added ability to change custom domain to be /docs directly through dashboard settings.
Added ability to see deployment status in dashboard settings.
Added ability to see deployment logs in dashboard settings.
Added login with Google OAuth
Added ability to add new deployment through dashboard settings.

1-4-25

UI/UX

Bug Fixes

Can now use leading slashes in navigation.
Fixed bug where clicking on a link in a dropdown would not close the dropdown.
Fixed bug where clicking on a link in a tab would not close the tab.
Fixed bug where clicking on a link in a modal would not close the modal.
Fixed bug where clicking on a link in a sidebar would not close the sidebar.
Fixed bug where clicking on a link in an accordion would not close the accordion.
Fixed bug where clicking on a link in a popover would not close the popover.
Fixed bug where clicking on a link in a tooltip would not close the tooltip.
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.
Codeblocks within callouts expand to fill the width of the callout area

1-3-25

UI/UX

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.

1-2-25

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.

1-1-25

Update Speed Performances

We’ve optimized the performance of updates. File downloads during updates are 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.

12-31-24

UI/UX

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.

12-29-24

UI/UX

Dashboard Improvements

App router migration in the dashboard.
Added ability to see deployment status in dashboard settings.
Added ability to see deployment logs in dashboard settings.
Fix incorrect analytics data.
Add-on’s can now be directly purchased through the dashboard.

12-27-24

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.
Troubleshooting for API pages: API pages could be complicated so we listed common issues to help you sort them out quickly — Read the docs

12-20-24

Add a chat widget to your docs. The widget comes with:

Contextual responses based on your docs
Support for code snippets
Ability to reference specific sections
Read the blog announcement

12-18-24

Pro Plan

We also updated our pricing plans for better customizability and scale.

Read the blog announcement

12-15-24

API Playground

API Playground Code Example Sync

When you browse API docs, the selected code example now syncs across your pages. This means you can select Python once and see Python examples everywhere.

12-13-24

Insights

Currently in beta, this feature summarizes common user questions and patterns from your docs. It helps you understand what users are looking for in your product.

12-11-24

Okta SSO

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

12-9-24

Mintlify REST API

Programmatically rigger updates to your documentation.

12-6-24

UI/UX

Custom mode

Add a configuration to the metadata to remove all elements except for the top bar.

{
  "mode": "custom"
}

Check out our Custom Mode docs.

12-4-24

Mintlify MDX for VSCode

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

12-2-24

UI/UX

Quality Improvements

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

11-29-24

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.
Mintlify MDX Engine: We’ve rebuilt our MDX engine to be more performant and extensible. You can now use MDX components in your docs without any additional configuration.
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.

11-27-24

UI/UX

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.

Changelog

​WebSockets

​AI Translations in beta

​Export docs to PDF in beta

​LLM shortcuts via contextual menu

​More models for AI chat

​Quality improvements

​Bug fixes

​MCP server generator

​Tailwind CSS support

​Quality improvements

​New configuration schema docs.json

​CI Checks

​More Themes

​Web editor improvements

​Revamped API Playground

​Quality Improvements

​Authentication

​AI Assistant

​GitLab Integration Upgrade

​Web Editor

​/llms.txt support

​Localization

​Quality Improvements

​Code Line Highlighting

​Light mode code blocks

​Advanced Footer

​Filter search based on the current user

​Custom Prompts for AI Chat

​Dashboard Improvements

​Bug Fixes

​Custom Fonts

​Images in Card components

​Update Speed Performances

​SEO improvements

​Dashboard Improvements

​Bug Fixes

​AI Widget

​Pro Plan

​API Playground Code Example Sync

​Insights

​Okta SSO

​Mintlify REST API

​Custom mode

​Mintlify MDX for VSCode

​Quality Improvements

​Launch Week Highlights

​Bug fixes

WebSockets

AI Translations in beta

Export docs to PDF in beta

LLM shortcuts via contextual menu

More models for AI chat

Quality improvements

Bug fixes

MCP server generator

Tailwind CSS support

Quality improvements

New configuration schema `docs.json`

CI Checks

More Themes

Web editor improvements

Revamped API Playground

Quality Improvements

Authentication

AI Assistant

GitLab Integration Upgrade

Web Editor

/llms.txt support

Localization

Quality Improvements

Code Line Highlighting

Light mode code blocks

Advanced Footer

Filter search based on the current user

Custom Prompts for AI Chat

Dashboard Improvements

Bug Fixes

Custom Fonts

Images in Card components

Update Speed Performances

SEO improvements

Dashboard Improvements

Bug Fixes

AI Widget

Pro Plan

API Playground Code Example Sync

Insights

Okta SSO

Mintlify REST API

Custom mode

Mintlify MDX for VSCode

Quality Improvements

Launch Week Highlights

Bug fixes