Skip to main content
​
January 23, 2026

​
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 visualisation.

​
Editor improvements

  • Editable icons
  • What-you-see-is-what-you-get title and description editing for Cards, Accordions, and Steps components
  • Hide and unhide pages from your navigation
  • Local image support in live preview
  • Code block triggering with ```
  • More precise drag handle selection
  • Stability 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

  • “Open in Grok” support in the contextual menu
  • Zip file upload support in onboarding

​
Bug fixes

  • Fixed a caching issue that caused the sidebar to show incorrect expanded/collapsed states when navigating between pages.
  • Resolved scroll position issues on custom pages so content displays correctly.
  • Fixed conflicts when multiple Mermaid diagrams appeared on the same page.
  • Fixed a rendering loop that could cause performance issues with the Tabs component.
  • Fixed the password reset button not working.
  • The AI assistant no longer appears when printing pages.
  • Fixed the cursor being invisible in dark mode.
  • Fixed a bug that could strip style attributes in MDX.
  • Fixed an issue where page “last modified” dates updated incorrectly during global config changes.
  • Fixed authentication issues affecting index pages from properly rendering.
  • GitHub status is now properly surfaced during onboarding if GitHub is down.
​
January 16, 2026

​
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

  • Combined authentication, partial authentication, and personalisation into a single authentication experience. See Authentication setup for more information.
  • Hidden pages now automatically receive noindex meta tags for better SEO control.
  • Added markdown support for image captions.
​
January 9, 2026

​
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

  • Live preview: See real-time changes as you edit your documentation in the web editor. Live previews show your site exactly as it appears when published, without creating a preview deployment.
  • Unused files section: The editor now shows unused pages that aren’t in your navigation, with drag-and-drop support to add them.

​
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

  • Fixed API reference base path issues.
  • Updated callout colours with a refreshed colour scheme.
  • Fixed images not displaying on initial load after uploading in the editor.
  • Fixed code styling within card links.
  • Fixed .md files incorrectly overwriting .mdx files.
​
January 9, 2026

​
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 analyses patterns in assistant conversations to identify documentation gaps and suggest improvements, helping you proactively address common user questions.

​
Tab and code group synchronisation

Tabs and code groups now synchronise 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

  • Tabs bottom border: Added optional bottom border styling for tabs.
  • Mermaid controls: Interactive controls for Mermaid diagrams to navigate large diagrams.
  • URL parameters for search and assistant: Open pages with the search modal prefilled with ?search= or the assistant with ?assistant=. User query parameters for direct linking and sharing knowledge.
  • Profile name editing: Users can now edit their first and last name in profile settings.