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