New updates and improvements
Learn more in the assistant docs.
Learn more in our new Changelog guide
Learn more at API playground docs.
mint update
Can now use mint update
to update your CLI.
Overhauled usability in the WYSIWYG editor.
Major improvements
Additional fixes
Translate all of your documentation with AI. Learn more.
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.
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.
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:
mint.json
file and push your changesAutomatically 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.
New pre-built themes to modify the look & feel of your docs. Configure via your docs.json file.
Now available:
docs.json
file editingCustomize 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:
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.
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.
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.
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.
Launched a new Update component to make it easier to display and report updates (like this one) to your users.
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.
Code blocks now have a light mode variant which can be enabled by adding the following to your docs.json
:
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.
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.
suggestEdit
not showing up even when enabled.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.
Add an img
property to a card to display an image on the top of the card. Learn more about it here.
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.
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.
sidenav
.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.
For Pro
users, 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.
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.
docs.json
file and it’ll update your docs styling.openapi
field to an object in tabs or anchors arrays in the docs.json
.Add a configuration to the metadata to remove all elements except for the top bar. Example use cases:
Check out our Custom Mode docs.
Call snippets of our pre-built components and callouts without leaving VSCode. Install the extension here.