> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Product updates

> Stay up to date with the latest Mintlify product updates, new features, platform improvements, bug fixes, and documentation tooling changes.

<Update label="June 26, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Google Drive agent integration, multi-source git settings, new onboarding, and more" }}>
  ## New releases

  * **Google Drive agent integration:** The agent can now pull context from Google Drive alongside Slack, Notion, Linear, Jira, and other [agent integrations](/agent/integrations).
  * **Multi-repository deployments:** Configure and reorder multiple Git sources for a deployment from the dashboard. See [multi-repo setup](/deploy/multi-repo).
  * **Assistant page navigation:** The [AI assistant](/assistant) can navigate users directly to a relevant page as part of its answer.
  * **Custom agent instructions in `llms.txt` and markdown:** Custom agent instructions are now included in [`llms.txt`, `llms-full.txt`](/ai/llmstxt), and per-page generated markdown.
  * **Mintlify Slack app in the Slack Marketplace:** The [Mintlify Slack app](/agent/slack) is now publicly listed and installable from the Slack Marketplace.

  ## Improvements

  * **Automation PR grouping:** When an [automation](/automations) run proposes new changes, it now checks whether they should be appended to an existing open docs PR rather than creating a new one, reducing duplicate PRs and review burden. Applies to Maintenance and Update from Code Changes automations.
  * **Automation GitHub PR review experience:** Docs PRs created by [automations](/automations) now post a comment each time they're updated, explaining what changed and which code PRs were used as context. PR titles identify which automation created them, reviewers are auto-assigned based on who changed the relevant code, and follow-up runs update the PR summary in place.
  * **HTML alternate link for markdown pages:** Every page now exposes an HTML `<link rel="alternate">` pointing to its [markdown version](/ai/llmstxt), making it easier for AI tools and crawlers to discover the LLM-friendly content.
  * **Real-time publish status in the editor:** The [editor](/editor) now shows publish actions as they happen so you can see exactly when a change goes live.
  * **Switch organization moved:** The **Switch organization** menu option is now in the profile dropdown menu.
  * **Cookie-consent gating for analytics:** Third-party analytics scripts (GA4, GTM, and others) are now blocked until a visitor accepts cookies, helping you meet privacy requirements.
  * **SSO enforcement on the frontend:** The dashboard now honors backend 403s for [SSO-only orgs](/dashboard/sso) and routes verified-domain users through SSO during sign-in.
  * **Search indexes section landing pages:** Section landing pages are now included in docs search results, and search indexes continue to build for sites that opt out of public indexing.
  * **Assistant CSV export grouping:** The assistant analytics CSV now includes a `Conversation ID` column and groups rows by conversation.
  * **MCP server identity and instructions:** The [Mintlify MCP server](/ai/mintlify-mcp) now advertises instructions on initialize, helping clients use it more effectively.
  * **Changelog automation runs show integration tools:** Automation runs that produce changelog entries now display the integration tools that were used.
  * **PDF export reliability:** Large PDF exports are now batched and produce clearer error logs when something goes wrong.

  ## Bug fixes

  * Subpath deployments now resolve `.well-known` links correctly.
  * Publishing from the editor no longer duplicates near-identical blocks during three-way merges.
  * Icon serialization in published pages is fixed.
  * Editor image uploads now retry if the request is rate limited.
  * MCP responses now forward upstream status codes correctly, and nested JSX is reconstructed properly for MCP clients.
  * The editor sidebar no longer renders a top fade gradient, and draft rows no longer show stale orange status dots.
  * Bold text inside headings renders with the correct weight.
  * The products selector dropdown column is wider so long names fit.
</Update>

<Update label="June 19, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Automations rename, SSO enforcement, self-hosting upgrades, and more" }}>
  ## New releases

  * **Workflows are now automations:** Introducing [automations](/automations). They have the same functionality as workflows, just a new name to better describe what they're helping you do.
  * **SSO enforcement and breakglass:** Org owners can enforce [SSO-only sign-in](/dashboard/sso) for members, configure verified domains, and manage breakglass emails from the dashboard for emergency access.
  * **Full PDF export for authenticated sites:** [Authenticated sites](/deploy/authentication-setup) can now generate full PDF exports, with auth cookies parsed so images and assets are included.
  * **Self-hosted improvements:** Self-hosted deployments can now serve a public docs domain, write `sitemap.xml` to S3 during static export, and support static exports. Webhooks now work in self-host mode.
  * **`mint analytics` command removed:** The command `mint analytics` is deprecated.

  ## Improvements

  * **Editor view changes:** Open an automation run's changed pages directly in the [editor](/editor) from the run review UI or Slack. Changed pages are highlighted, and unlisted pages are openable from the branch diff.
  * **Typing performance:** Fixed typing lag on long pages in the editor.
  * **Mintlify bot reliability:** The `@mintlify` GitHub bot is now more reliable across multi-comment iterations and posts a direct "view changes" link.
  * **Preview deployments:** Preview deployments now rebuild on push and are created from new webhook events for faster previews.
  * **Search modal redesign:** The search and assistant modal is redesigned with full keyboard and accessibility support and no flicker on open.
  * **Mobile menu redesign:** The docs topbar mobile menu has a refreshed design.
  * **Product dropdown menus:** Product dropdowns now support nested menus and divisions.
  * **Luma wide mode:** `mode: "wide"` now affects content positioning in the Luma theme.
  * **CLI hot reload:** `docs.json` hot reload is faster in the CLI.

  ## Bug fixes

  * Bold text inside headings now renders with the correct font weight.
  * Search modal primary color now matches the configured theme.
  * Authenticated MCP requests propagate upstream responses to clients, and the authed MCP config rate limit was raised.
  * Failed React components in the dashboard now render an error boundary instead of crashing the page.
  * Removed the copy button from command-line code blocks where it wasn't useful.
  * Duplicate merged changes during Git sync are now de-duplicated.
  * MCP OAuth routes are hidden when auth is disabled.
  * Assistant captcha copy updated for clarity.
</Update>

<Update label="June 12, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Authenticated sites on Starter plan, editor improvements, and more" }}>
  ## Authenticated sites on Starter plan

  * **Mintlify auth on Starter:** [Mintlify-managed authentication](/deploy/authentication-setup) is now available on the Starter plan.

  ## Editor improvements

  * **Drafts and publishing flow:** Make changes in a draft, request review, and publish — all from the [web editor](/editor). Drafts autocommit as you work, and renaming or updating a draft updates the underlying pull request.
  * **Create non-`.mdx` files:** Add JSON, YAML, and other supported file types directly from the editor file tree.
  * **Topbar redesign:** A cleaner editor topbar with reorganized controls.
  * **Faster initial load:** The editor's first file and navigation load is significantly faster, with prefetching for visible nav tree pages.
  * **New link UX:** A redesigned inline link editor in the WYSIWYG view.
  * **Folding and sticky headings:** Long pages support collapsible headings, and sticky headings are clickable to jump back up the page.
  * **Render reason in agent panel:** The editor's agent panel now shows the reason behind each action it takes.
  * **PR review polling:** The editor polls for PR review status so reviewer feedback shows up without a refresh.

  ## Search and AI

  * **Markdown in search results:** Search via MCP, the assistant, and the agent now returns markdown, giving AI clients better page context.
  * **Project-level noindex:** Site owners can hide an entire project from search engines.
  * **Unversioned search:** Pages without a version are included in search results when `searchSettings.unversioned` is set, with breadcrumbs that show their version context.
  * **Claude Code classification:** Analytics now recognize Claude Code user agents and count AI agent HTML pageviews alongside markdown views.

  ## Bug fixes

  * Long-queued or stalled automation runs now time out reliably after 25 hours.
  * Renaming files between `.mdx` and other extensions in the editor now works.
  * Click-to-reposition the cursor in the editor file tree rename input.
  * Adding files to `docs.json` in the editor no longer requires a reset.
  * Image renames in the editor now work.
  * The active page node is revealed in the editor navigation on load.
  * Search results anchor to the page top or title-matching section instead of arbitrary subsections.
  * Bad frontmatter no longer crashes page builds.
  * Automations home banner shows a toast when a custom automation delete fails, and prefers an error message over a summary for failed runs.
  * "Ran x ago" labels tick during polling.
  * Live badges across the product now use a consistent check icon.
  * Favicon proxy handles encoding headers correctly.
  * Duplicate navigation group names render without collisions.
  * Renamed contextual menu action "Open in Windsurf" to "Open in Devin Desktop" and uses the `devin://` deep link.
</Update>

<Update label="June 5, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Agent and automation integrations, search upgrades, and more" }}>
  ## Agent and automation integrations

  * **Agent integrations:** The agent can now connect to more third-party apps, including Google Calendar, Intercom, Jira, Linear, Notion, Salesforce, and Slack.
  * **Automation integrations:** Automations can use the same third-party apps as context for automation runs.

  ## Slack agent

  * **Enterprise Grid support:** The [Slack agent](/agent/slack) now installs on Slack Enterprise Grid and org-wide workspaces.
  * **Streaming work:** The agent now streams rich updates while it works, so you can follow along with what it's doing in Slack.
  * **Manage billing button:** The credits-exhausted reply now includes a one-click **Manage billing** button.

  ## Search

  * **Better ranking:** In-product search now supports prefix matching, title-match promotion, and unicode tokenization, so partial queries and identifier searches surface the right pages faster.
  * **Word-prefix highlighting:** Matching word prefixes highlight in search results.

  ## Improvements

  * Automation stale review reminders: [Automations](/automations) that open pull requests now send Slack reminders when reviews go stale.

  ## Bug fixes

  * Initial file and navigation load in the [web editor](/editor) is faster.
  * Switching between deployments in the editor now works more reliably.
  * The agent history view scrolls correctly.
  * Files in the editor file tree alphabetize after you create a new file.
  * Accordions open automatically when you navigate to their hash anchor on the same page.
  * The editor agent shows its overage and credit status before you send a message.
  * Slack agent installs are rejected when the workspace is already owned by another organization, preventing cross-org conflicts.
  * Future date selection in the dashboard uses the correct styles.
</Update>

<Update label="May 29, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Editor and agent upgrades, new automations, API playground callbacks, and more" }}>
  ## Editor

  More ways to edit and configure your docs directly from the [web editor](https://www.mintlify.com/docs/editor):

  * **Visual `docs.json` editor:** A redesigned configuration editor lets you edit `docs.json` visually and sync changes back to the navigation tree.
  * **Page settings panel:** The new page settings panel lets you view and edit frontmatter in the file explorer view.
  * **Hide branches toggle:** A new toggle hides branch indicators in the editor view for a cleaner workspace.
  * **Better link editing:** Editing inline links is faster with an improved link editor experience.
  * **Fullscreen table mode:** Edit large tables in a dedicated fullscreen view.
  * **Drag and drop Markdown:** You can now drag and drop Markdown files into the editor to upload them.
  * **Brand icons in icon picker:** Brand icons are now available alongside the rest of the icon library.

  ## Editor agent

  * **Searches Mintlify docs:** The agent can now search the Mintlify documentation while you work in the editor, so you're always connected to the source of truth for Mintlify while updating content.
  * **Edit and delete non-content files:** The agent can manage non-content files in your repository in addition to pages.
  * **File attachments:** Attach files directly to the agent.
  * **Interrupt mid-stream:** Stop the agent while it's streaming a response if you want to redirect it.

  ## Automations

  * **Draft improvements from user feedback:** This new automation reviews recent [page feedback](/optimize/feedback) and opens pull requests based on what users report.
  * The **update from code changes** automation (formerly sync content with code) defaults to run on a schedule rather than triggering on every code change. When it runs, the agent scans all code changes since the last run and opens one PR per related set of documentation updates. If a PR is still open from a previous automation run, new changes are appended to it rather than creating a new PR. This means a release worked on over several weeks produces a single docs PR to review instead of one per commit.
  * Automation titles and copy across the dashboard have been refreshed for clarity.

  ## API playground

  * **Callbacks on API reference pages:** OpenAPI `callbacks` now render on API reference pages so readers can see the requests your API sends back.
  * **Download API spec:** A new **Download API spec** option is available from the contextual menu on API reference pages.

  ## 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:

  * Enabling and disabling automations
  * Creating custom automations
  * Managing authentication settings
  * Configuring custom domains
  * Reading and analyzing analytics data

  ## Agent discoverability

  * **MCP server card:** Mintlify now serves an MCP server card at the well-known paths MCP scanners probe, including server info and customer name, making it easier for clients to discover your MCP server.
  * **Content-Signal directives:** Tenant `robots.txt` files now include Content-Signal directives to communicate AI usage preferences to crawlers.
  * **AI discoverability for partially authenticated sites:** Deployments with [partial authentication](/deploy/authentication-setup) now serve `sitemap.xml`, `llms.txt`, `llms-full.txt`, and `robots.txt` publicly, so AI crawlers and agents can discover your content even when parts of your site require authentication.

  ## Improvements

  * Switch organizations without signing out: You can now move between organizations with one click. No more re-authenticating to switch projects.
  * Snippet variables in code blocks: [Reusable snippets](/create/reusable-snippets) now support variables inside code blocks, so you can parameterize examples consistently.

  ## Bug fixes

  * Custom heading IDs now preserve casing (camelCase, snake\_case, kebab-case).
  * Navigation breadcrumbs render above page-level hits in search results.
  * Enum defaults pre-populate when you add new array items in the API playground.
  * `.xml` files are now treated as valid link targets by the broken-links checker.
  * Changelog pages now include an RSS feed discovery meta tag so readers can subscribe directly from the page.
  * Bullet point behavior in the editor is fixed, including continuing and exiting lists.
  * Pasting copied web images no longer creates duplicate broken image nodes.
  * Large editor media uploads now use direct-to-S3 presigned URLs, bypassing the previous 4.5 MB function payload limit.
  * GitHub edit links now work correctly for `.md` pages.
  * Slash commands and the file settings sheet behave correctly in the file tree.
</Update>

<Update label="May 22, 2026" tags={["New releases","Improvements"]} rss={{ title:"Web editor enhancements, new automation, search improvements, and more" }}>
  ## Web Editor

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

  * **More editable file types:** A broader set of file extensions can now be opened and edited directly in the web editor, while executable uploads are blocked for safety.
  * **Agent chat panel relocated:** The agent chat panel has been repolished and now sits to the left of the file explorer, making it easier to chat and navigate at the same time.
  * **Editor settings:** A new settings panel and redesigned settings modal give you a single place to manage per-editor preferences. See [Web editor](https://www.mintlify.com/docs/editor).
  * **File-tree navigation by default:** Newly onboarded users start in the file-tree view instead of the legacy list view.
  * **Browser tab titling:** The browser tab name now dynamically updates to match the active file, so you always know which file you're editing.

  ## Automations

  * New **Draft improvements from assistant conversations** automation reviews trends from user questions and suggests documentation updates to address gaps. See [Automations](/automations/reference#draft-improvements-from-assistant-conversations).
  * **Context repositories** can now be configured directly for some automations so you can add the repos an automation should reference while running.
  * Automation settings now open in a **side panel** instead of a modal, making it easier to tweak settings while reviewing Automation Runs.

  ## Search Improvements

  * **Maximum search results** lets you control how many results the in-product search bar returns per query. Tune this alongside search boosts to fit how readers navigate your docs. See [Search](https://www.mintlify.com/docs/optimize/search#maximum-search-results) for details.
  * **Searchable hidden tabs and groups:** Hidden tabs and groups now support a `searchable: true` option that exposes their descendant pages to in-product search, the sitemap, and AI context. Use it when you rely on hidden tabs in your navigation (for example, for per-product isolated sidebars) and still want those pages indexed. See [Hidden pages](https://www.mintlify.com/docs/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups) for details.

  ## Improvements

  * **Slack Agent**: The [Slack agent](https://www.mintlify.com/docs/agent/slack) now supports **GitLab** alongside GitHub for repository-aware automations.
  * **Sidebar Navigation:** Sidebar navigation state and scroll position are now preserved across page navigation.
  * **Accessibility:** Accessibility improvements across docs, including the table of contents and mobile agent panel.
  * **AsyncAPI schemas**: Array and combinatorial (`oneOf` / `anyOf` / `allOf`) schemas now expand to show their child attributes in the API reference.
  * **API playground**: `any` and `undefined` types are now handled like `oneOf` schemas, letting users pick a concrete shape when sending a request.
</Update>

<Update label="May 15, 2026" tags={["New releases","Improvements"]} rss={{ title:"Web editor redesign, expanded agent support, billing improvements, and more" }}>
  ## Web Editor

  The [editor](https://www.mintlify.com/docs/editor) has been redesigned for live collaboration, parsing, and stability. Additional improvements include:

  * **Agent panel**: Chat with the editor agent inline — attach files, view per-session diffs, leave feedback, and jump to the page the agent edited.
  * **Add to Assistant**: Send highlighted content straight to the [Assistant](https://www.mintlify.com/docs/assistant) from the editor toolbar.
  * **File tree**: Create folders, create unlisted pages, and rename items in the file tree. Add unlisted Markdown into the navigation tree, and open unlisted Markdown and media files directly from the tree.

  ## Improvements

  * **Automations**: New **Add GitHub repositories** link in the Automations repository dropdown makes it easier to connect additional repositories without leaving the page. The Automation Runs tab now defaults to **All runs** when nothing currently needs review, and a **View all runs** button on the empty state clears active filters in one click.
  * **Mintlify Agent**: The [Mintlify agent](https://www.mintlify.com/docs/agent/slack) can now be installed in your Slack workspace even without having a Mintlify-hosted deployment. Additionally, viewer-role users can now ask questions and get answers using read-only tools, and the agent now uses prior thread images and message reactions as additional context.
  * **Schema graph callbacks**: API reference pages now render OpenAPI `callbacks` in the schema graph.
  * **Danish language support** added.

  ## Bug fixes

  * Restored the editor's agent history panel.
  * Fixed live collaboration for hidden blocks in the editor.
  * Fixed cases where the source editor would misparse content.
  * Fixed `Cmd+B` so it toggles the nav sidebar from anywhere in the dashboard.
  * Fixed keyboard navigation and default open state for the agent panel.
  * Fixed thumbs-up/down feedback being double-counted in the analytics dashboard.
  * The chat CSV export now always includes the **Query category** column.
  * Fixed an issue where root pages could be incorrectly stamped as public.
</Update>

<Update label="May 8, 2026" tags={["New releases","Improvements"]} rss={{ title:"Expanded MCP access, assistant credit packages, AsyncAPI nested groups, and more" }}>
  ## Expanded MCP content access

  Authenticated [MCP servers](/ai/model-context-protocol) 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](/ai/model-context-protocol#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](/ai/mintlify-mcp) documentation for more details.

  ## Assistant credit packages

  The [assistant](/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](/api-playground/asyncapi-setup#examples-with-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

  * [Slack agent](/agent/slack) now requests permission to run third-party actions such as sending an email or creating a ticket.
  * The [editor](/editor) now lets you drag images and videos from the navigation tree directly onto a page to embed existing media inline.
  * Mermaid diagrams in the editor now support a fullscreen mode for easier editing of complex diagrams.
  * The custom domain dashboard now displays both verification `TXT` records (`_acme-challenge` and `_cf-custom-hostname`) with live verification status, so you can confirm DNS is correct before pointing your `CNAME` at Mintlify. See [custom domain](/customize/custom-domain) for more details.
  * TLS certificate provisioning for [custom domains](/customize/custom-domain#automatic-tls-provisioning) is now handled directly by Mintlify.
  * GitLab-connected deployments can now revalidate their Git source from the [Git settings](https://app.mintlify.com/settings/deployment/git-settings) page by clicking the **Active** badge, useful when branch options or configuration appear stale.
  * The [feedback dashboard](/optimize/feedback) detailed feedback view now only shows submissions that include written comments, making qualitative feedback easier to scan.
</Update>

<Update label="May 1, 2026" tags={["New releases","Improvements"]} rss={{ title:"Revamped automations and editor, agent score, new Mintlify MCP, and more" }}>
  ## Automations

  Automations have been rebuilt with a new [dashboard experience](https://app.mintlify.com/products/automations).

  * **Optimized automation templates**: Mintlify maintains prompts for common content creation and maintenance tasks. Turn on these automations and let the agent handle the rest. Mintlify routinely improves the prompts so that you don't have to.
  * **Quicker setup**: Toggle on an automation and adjust any optional settings. No more YAML configuration or iterating on Markdown prompts.
  * **Custom automations**: In addition to built-in automations, you can create your own automations.

  See the [automations](/automations) documentation for more details.

  ## Editor

  The [editor](https://app.mintlify.com/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](/editor) documentation for more details.

  The classic editor sunsets in May 2026.

  ## Agent score

  [Agent score](http://mintlify.com/score) evaluates how agent-ready your site is. It is a free tool built on the open source [AFDocs spec](https://afdocs.dev) 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](/ai/mintlify-mcp) documentation for more details.

  ## Agent connections

  Ask the agent in [Slack](/agent/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](https://docs.composio.dev/toolkits) to support a broad catalog of third-party services, including issue trackers, knowledge bases, CRMs, and developer tools. See the [Composio toolkits catalog](https://docs.composio.dev/toolkits) 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](/optimize/search#boost-search-ranking) documentation for more details.

  ## Improvements

  * Control whether OpenAPI-generated reference pages are included in your [Markdown export](/ai/llmstxt) and `llms-full.txt`
  * Search improvements: matched query terms highlighted in search results, search indexes content inside alt text, tag-based search filters are case-insensitive, and snippets no longer duplicate page titles.
  * Banner components support more types and per-user dismissibility.
  * Authenticated navigation now stays sticky while scrolling.
  * The [Slack agent](/agent/slack) can now clone any repository the Mintlify GitHub App has access to and is aware of every repo in your org when answering questions.
  * The Assistant CSV export and API now include resolution status for each conversation.
  * `llms-full.txt` correctly prefixes root-relative links with your deployment's base path.
  * Pages served as Markdown now include an `llms.txt` directive in the HTML version so agents can discover the AI-friendly route.

  ## Bug fixes

  * Fixed copying of personalized code blocks so the rendered values are copied instead of the templated source.
  * Fixed prefetching incorrectly attempting to fetch external links.
  * Fixed prose styling for the [Tabs](/components/tabs) component.
  * Fixed offset alignment for blocks placed inside a [Column](/components/columns).
  * Fixed code block loading flicker on Chromatic-hosted sites.
  * Fixed AsyncAPI reference page content positioning.
  * Fixed media file paths with special characters not loading correctly.
  * Fixed search results not finding bare queries like `search`.
  * Fixed self-serve deployment errors in the dashboard.
  * Fixed an automation card toggle that could blank the dashboard page.
</Update>

<Update label="April 24, 2026" tags={["New releases","Improvements"]} rss={{ title:"Preview Deployment API, Git onboarding redesign, web editor improvements, and more" }}>
  ## 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](/api/preview/trigger) 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.

  * **Emoji picker**: Type <kbd>:</kbd> to open an emoji picker and insert emojis inline.
  * **Accordion reordering**: Drag and drop to rearrange accordions inside an [accordion group](/components/accordions) without editing MDX.
  * **Editable color component**: Update [color](/components/color) swatches directly in the editor without editing MDX.
  * **SVG file upload**: Upload SVG files from the editor configuration view.

  ## Redirect destination checks

  The [mint broken-links](/cli/commands#mint-broken-links) command now supports an option to validate redirect destinations. Catch redirects that point to missing pages before they reach production.

  ## Improvements

  * Pages expose a `data-current-path` HTML attribute for easier custom scripting and analytics targeting.
  * Hidden pages now respect the `seo.indexing: all` setting so you can still index specific pages that are excluded from navigation.

  ## Bug fixes

  * Fixed Git source privacy validation so private repositories are correctly detected after saving Git settings.
  * Fixed a parsing issue where a single `$` was treated as inline math. Dollar signs now render as plain text unless wrapped in math delimiters.
  * Fixed broken-links false positives on API reference pages generated from OpenAPI specs.
  * Fixed OpenAPI endpoint resolution when paths contain trailing slashes.
  * Fixed the `mint` CLI version resolving incorrectly when run via `npx`.
  * Fixed the create PR button not re-enabling after saving changes on a branch in the editor.
  * Fixed symlink handling for skill files stored outside the content directory.
  * Fixed the Luma integration table of contents position.
  * Fixed deployment URLs not including the page href for direct links.
</Update>

<Update label="April 17, 2026" tags={["New releases","Improvements"]} rss={{ title:"Visibility component, MCP filesystem access, agent feedback, Git setup wizard, and more" }}>
  ## Visibility component

  The new [`Visibility`](/components/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](/ai/markdown-export) consumed by AI tools. Useful for tailoring instructions, examples, or formatting to each audience without maintaining separate pages.

  ## Agent feedback

  Enable [agent feedback](/optimize/feedback#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](/ai/model-context-protocol) 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](/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

  * Pasting valid MDX components into the editor now preserves component structure instead of converting to plain text.
  * Long sidebar navigation titles now hyphenate automatically to prevent overflow.
  * The editor now resolves [`$ref` references](/organize/settings#split-configuration-with-%24ref) in split configuration files.
  * The [Slack agent](/agent/slack) system prompt has been improved for more accurate and helpful responses.
  * `llms.txt` now includes blockquote summaries for better page descriptions.
  * Custom `skill.md` files in your repository are now detected correctly during deployment.

  ## Deprecations

  * File-based automations are deprecated. Create automations from the dashboard instead. Existing automations from files continue to work, but new automations must be created in the dashboard.

  ## Bug fixes

  * Fixed instances of relative links in `index.mdx` files not resolving correctly.
  * Fixed the copy button for code blocks in assistant responses.
  * Fixed the table of contents not updating after page content changes.
  * Fixed code block titles not displaying correctly.
  * Fixed default border color for dark mode.
  * Fixed the `mint analytics feedback` CLI command sending incorrect feedback type values.
  * Fixed a shadow artifact on number stepper buttons.
  * Fixed client-side navigation for related links.
</Update>

<Update label="April 10, 2026" tags={["New releases","Improvements"]} rss={{ title:"CLI analytics, directory listings, multi-skill support, Slack bot improvements, and more" }}>
  ## 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:

  * `mint analytics stats` — views, visitors, searches, feedback, and assistant usage for a date range
  * `mint analytics search` — search queries with hit counts and click-through rates
  * `mint analytics feedback` — page and code snippet feedback submitted by users
  * `mint analytics conversation list` — recent assistant conversations

  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](/organize/navigation#root-page) can now display a [directory listing](/organize/navigation#directory-listings) 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](/ai/skillmd) 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

  * **Multiple deployments**: Organizations with multiple documentation sites can now use the [Slack agent](/agent/slack) across all of them. The agent prompts you to choose a deployment on first use, and your preference is saved per Slack account.
  * **Read-only mode**: The Slack agent now classifies messages and responds in read-only mode for questions that only need information retrieval, reserving write access for requests that require documentation changes.

  ## Client credentials for authenticated MCP

  [Client credentials](/ai/model-context-protocol#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

  * The [`mint new`](/cli/commands#mint-new) command now supports creating projects from pre-defined templates with the `--template` flag.
  * The CLI now auto-refreshes expired access tokens, so you no longer need to re-run `mint login` after a session expires.
  * The [assistant](/assistant/index) is now available in `mint dev` local previews.
  * CLI UX improvements: grayed-out login URLs for clarity, standardized log formatting, and `mint status` now shows the CLI version.
  * OpenAPI `x-group` extension support for organizing API endpoints into custom groups.
  * Horizontal rules (`<hr />`) are now supported in MDX content.
  * [Automations](/automations) now surface in the dashboard inbox for easier tracking. The automation list also displays PR names for quicker identification.
  * The `mint export` command now includes API reference pages generated from OpenAPI specifications.
  * The slash command menu in the editor has been redesigned with improved organization and discoverability.
  * Improved the UI of the editor publish flow and page creation interface.
  * Improved abuse prevention for the assistant.
  * Added Finnish as a supported localization language.

  ## Bug fixes

  * Fixed custom heading IDs not being processed before MDX parsing, which could cause anchors to break on certain pages.
  * Fixed the SEO and metadata audit automation template from incorrectly modifying API endpoint pages.
  * Fixed deprecated label text wrapping in the dashboard.
  * Fixed inline formatting (bold, italic, code) not applying correctly in the editor in certain contexts.
  * Fixed directory folder icon colors not matching the configured theme.
  * Fixed a badge illustration rendering issue in the dashboard.
  * Fixed an issue where switching branches could leave the editor in an inconsistent state.
  * Fixed API response example generation failing for certain OpenAPI schema types.
  * Fixed pages marked as hidden still appearing in the sitemap.
</Update>

<Update label="April 3, 2026" tags={["New releases","Improvements"]} rss={{ title:"get_page MCP tool, password-protected previews, SAML group role mappings, and more" }}>
  ## get\_page MCP tool

  [MCP servers](/ai/model-context-protocol) 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](/deploy/preview-deployments) now support password-protection. Share preview links without exposing content publicly.

  ## SAML group role mappings

  Organizations using [SAML SSO](/dashboard/sso) can now map SAML groups to dashboard roles for automatic role assignment when team members sign in.

  ## Improvements

  * Redesigned the editor configuration settings page with an improved layout and autosave support.
  * Pages auto-generated from OpenAPI specifications now appear in the web editor as read-only entries.
  * Video support in [live preview](/editor/live-preview). Embedded mp4, webm, and mov files now render correctly during local development.
  * [Automations](/automations) can now be disabled and re-enabled from the dashboard.
  * Assistant analytics now show usage broken down by source (web vs API) in the dashboard.
  * Authenticated MCP search now correctly filters results based on the user's authentication groups.
  * Slack agent responses now show tool call summaries instead of raw tool calls for clearer information of what the agent is doing.
  * Frontmatter `title` and `sidebarTitle` now take precedence over inferred metadata in the sidebar.
  * MDX content in page descriptions now renders correctly on authenticated deployments.

  ## Bug fixes

  * Fixed API playground request body construction for certain endpoints.
  * Fixed light and dark mode image parsing in the editor.
  * Fixed layout shift caused by the text selection tooltip.
  * Fixed badge and icon visual diff detection in the editor.
  * Fixed OpenAPI title and description not resolving for pages referenced by file path.
  * Fixed [automation](/automations) automerge toggle not properly disabling when set to off.
  * Fixed API playground including optional object fields with required children in generated request bodies.
  * Fixed keyboard activation for the feedback analytics table selection checkbox.
</Update>

<Update label="March 27, 2026" tags={["New releases","Improvements"]} rss={{ title:"Linear and Notion integrations, offline exports, inline AI editing, and more" }}>
  ## 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](/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`](/deploy/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](/organize/settings#split-configuration-with-%24ref). 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](/customize/custom-scripts#css-selectors) 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](https://schemas.agentskills.io/discovery/0.2.0/schema.json). AI agents can programmatically discover and fetch your [skill files](/ai/skillmd#discovery) with content integrity verification.

  ## API playground credentials

  A new [`api.playground.credentials`](/api-playground/overview) 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

  * [Custom heading IDs](/create/text#custom-heading-ids) now supported. Search results deep-link to sections that use custom IDs.
  * Navigation entries in `docs.json` now support anchor links (`#` links).
  * Automations dashboard redesigned with card view, clearer run history, action dropdowns, and improved empty states.
  * Editor navigation now syncs with the server for persistent changes and multi-user conflict resolution.
  * MCP search now respects authentication permissions, so search results only include pages the user has access to.
  * [Heap analytics](/integrations/analytics/heap) now properly forwards page views and custom events.

  ## Bug fixes

  * Fixed Luma theme primary button color not applying from `docs.json`.
  * Fixed code block tooltips using incorrect tooltip primitives.
  * Fixed live preview fallback behavior in the editor.
  * Fixed links in static HTML content within the editor.
  * Fixed icon paths on authenticated deployments.
  * Fixed navigation root pages on authenticated deployments.
  * Fixed text selection tooltip positioning.
  * Fixed assistant CSV export missing the sources column.
  * Fixed nested code block parsing.
  * Fixed padding for tables inside tabs.
  * Fixed Frame component hint icon vertical alignment.
  * Fixed navigation item badge wrapping.
  * Fixed API key being erased during prefill examples.
  * Fixed linked code snippets in cards not being clickable.
</Update>

<Update label="March 20, 2026" tags={["New releases","Improvements"]} rss={{ title:"Authenticated MCP route, contextual menu expansions, self-hosted GitLab UI, and more" }}>
  ## Authenticated MCP route

  A new authenticated route is available for [MCP](/ai/model-context-protocol) servers, enabling secure search over documentation sites with authentication enabled.

  ## New contextual menu options

  The [contextual menu](/ai/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](/deploy/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

  * User profile pictures now displayed throughout the dashboard for a more personalized experience.
  * Automation templates updated with improved prompts.
  * Automation run history now viewable from the dashboard with the ability to monitor status and close PRs.
  * Slack notifications for automations now configurable from the dashboard.
  * Editor performance improvements: fixed typing latency and persistence blocking in large repositories, virtualized file lists for repositories with many files.
  * Card layout shift on initial page load eliminated.
  * Dashboard analytics date-picker responsiveness improved.
  * Search now uses a unified endpoint with improved performance and consistency.

  ## Bug fixes

  * Fixed Columns component layout regression
  * Fixed AsyncAPI enum parameters showing as plain type strings.
  * Fixed Aspen and Luma theme layout issues.
  * Fixed columns component layout breaking across multiple themes.
  * Fixed banner-related layout shift in the Luma theme.
  * Fixed API playground prefill examples not working in certain themes.
  * Fixed Markdown list rendering in the API playground.
  * Fixed base path not applied correctly to internal links.
  * Fixed base path incorrectly applied to protocol-relative links.
  * Fixed nested block elements inside lists.
  * Fixed code block tooltip appearing for Prompt and Mermaid components.
  * Fixed hidden page children not appearing in decorated navigation.
</Update>

<Update label="March 13, 2026" tags={["New releases","Improvements"]} rss={{ title:"Automation templates and CLI command, Agent API v2, and more" }}>
  ## Automation templates

  Create [automations](/automations) faster with pre-built templates in the [dashboard](https://app.mintlify.com/products/automations). 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](/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](/api/agent/v2/create-agent-job). 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](/optimize/analytics) dashboard.

  ## Improvements

  * YouTube and Loom embeds available in the editor slash command menu
  * Localized footer and navbar content per locale
  * Slack assistant shows status indicators while processing
  * Automations can now send Slack notifications with auto-merge status
  * Editor now supports spellcheck
  * Dashboard layout improvements for mobile and responsive views

  ## Bug fixes

  * Fixed HTTP redirect status codes to use the proper 308 and 307 responses
  * Fixed sidebar flicker with advanced footer configuration
  * Fixed margin spacing for first item inside tabs
  * Fixed editor refresh issues
  * Fixed PDF export styling issues
  * Fixed footer hidden on custom pages for Mint, Maple, Willow, and Linden themes
  * Fixed `.md` routes not generating titles from slugs
  * Fixed cron automations created via the dashboard not auto-triggering
  * Fixed recursive automation runs
  * Fixed agent from re-creating a PR when prompted for follow up changes
  * Fixed agent session errors for multi-lingual sessions
</Update>

<Update label="March 6, 2026" tags={["New releases","Improvements"]} rss={{ title:"Auto-generate documentation from public GitHub repositories, assistant multimodality, and more improvements" }}>
  ## Auto-generate documentation from public repositories

  [Auto-generate a complete documentation site](https://mintlify.com/explore) 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](/assistant/index) 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](/assistant/configure#add-sample-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](/deploy/ci#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

  * Automations now support up to 50 runs per day, increased from 20.
  * [Full base URL](/organize/settings-api) now supported in the API playground by configuring `api.url` in `docs.json`.
  * Dashboard layout updated with improved navigation and sidebar access for the editor and settings pages.
  * Editor search bar redesigned with better UX for finding and navigating to files.
  * Nested drag-and-drop support for lists in the editor.
  * Twoslash support for inline TypeScript type information in code blocks.
  * Deployment history now distinguishes between queued and in-progress states.

  ## Bug fixes

  * Fixed OAuth and JWT redirects for authenticated docs.
  * Fixed cursor jumping when pasting text in the editor.
  * Fixed keyboard shortcuts for canceling assistant messages.
  * Fixed branch names with underscores not working in the editor.
  * Fixed link border colors in callout components.
  * Fixed mobile zoom behavior for input fields.
</Update>

<Update label="February 27, 2026" tags={["New releases","Improvements"]} rss={{ title:"Automate documentation tasks with automations and collaborate in the editor with comments and suggestions" }}>
  ## Automations

  Automate documentation tasks with [automations](/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](/customize/themes) available for a minimal, calm design.

  ## Improvements

  * Search filters now support filtering by language.
  * Rename files in the editor file tree.
  * Global variables support in the API playground.
  * OpenAPI and AsyncAPI specs now included in [llms.txt](/ai/llmstxt).
  * Adobe Analytics integration support.
  * Model Context Protocol (MCP) now works with [partially authenticated docs](/ai/model-context-protocol).

  ## Bug fixes

  * Fixed 404 pages returning incorrect HTTP status codes.
  * Fixed merge conflict resolution in the editor.
  * Fixed Mermaid diagram placeholder rendering.
  * Fixed frontmatter parsing in the editor.
  * Fixed table tooltip positioning.
  * Fixed dark/light image rendering without Frame wrapper.
</Update>

<Update label="February 20, 2026" tags={["New releases","Improvements"]} rss={{ title:"Agent configuration files and custom frontend" }}>
  ## `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](/assistant/customize) and [Customize agent behavior](/agent/customize) 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](/guides/custom-frontend) for more information.

  ## Improvements

  * New search functionality in the web editor makes it easier to find and navigate to files across your documentation.
  * Drag to add table rows and columns directly in the editor for faster table creation and modification.
  * The API playground now supports audio response examples, making it easier to document audio-related API endpoints.

  ## Bug fixes

  * Fixed layout shift issues in the Sequoia theme.
  * Fixed logout timeout issues.
  * Fixed accordion ID deduplication to prevent duplicate anchor links.
  * Improved SVG sanitization for better security.
</Update>

<Update label="February 13, 2026" tags={["New releases","Improvements"]} rss={{ title:"Prompt component, Sequoia theme, Tabler icons, and editor improvements" }}>
  ## Prompt component

  Use the [prompt](/components/prompt) component to display copyable prompts. Designed for sharing AI prompts and supports opening prompts directly in Cursor.

  ## Sequoia theme

  The [Sequoia theme](/customize/themes) features redesigned table of contents with the [contextual menu](/ai/contextual-menu) in the sidebar.

  ## Tabler icon support

  You can now use [Tabler icons](https://tabler.io/icons) throughout your documentation by setting `"library": "tabler"` in your `docs.json` icons configuration.

  ## Add MCP in contextual menu

  The [contextual menu](/ai/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`](/organize/navigation#root-page) 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

  * Improved editing experience for table, accordion, and card components.
  * Global block selection for easier multi-block editing.
  * Improved branch creation and pull request workflow with clearer status indicators.

  ## Feedback email capture

  The [feedback](optimize/feedback) form now includes an optional email field so users can provide contact information when submitting feedback.
</Update>

<Update label="February 6, 2026" tags={["New releases","Improvements"]} rss={{ title:"Self-serve SSO, viewer role, human/AI traffic toggle, and slash command redesign" }}>
  ## 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

  * Fixed table cell overflow in dashboard tables.
  * Renaming files via the configuration sheet in the editor now properly saves changes.
  * MDX parsing errors, like an unclosed `<Card>` tag, now update dynamically as you fix them instead of persisting incorrectly across reloads.
  * Drag-and-drop handles in the editor now align correctly with different content types like headings or paragraphs with consistent sizing and better hit areas.
</Update>

<Update label="January 30, 2026" tags={["New releases","Improvements"]} rss={{ title:"Simplified skills installation, revamped analytics, editor improvements, and more" }}>
  ## Skills installation simplified

  Install [skill.md files](/ai/skillmd) using just a documentation URL. No path to the `skill.md` file needed.

  ```bash theme={null}
  npx skills add mintlify.com/docs
  ```

  ## Revamped analytics page

  Improved navigation between [analytics](optimize/analytics) tabs. More actionable insights and better data visualization.

  ## 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](/assistant/index) in one page with a cleaner layout and better UX.

  ## MCP filtering

  AI agents can now [filter](ai/model-context-protocol#search-filtering-parameters) MCP search results by parameters.

  ## Other

  * "Open in Grok" support in the [contextual menu](/ai/contextual-menu)
  * Zip file upload support in [onboarding](deploy/github#clone-to-your-own-repository)

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

<Update label="January 23, 2026" tags={["New releases","Improvements"]} rss={{ title:"skills.md, audit logs, and markdown export" }}>
  ## `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](/ai/skillmd) for more information.

  ## Audit logs for authentication events

  Events are now tracked in [audit logs](/dashboard/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 personalization into a single authentication experience. See [Authentication setup](/deploy/authentication-setup) for more information.
  * Hidden pages now automatically receive `noindex` meta tags for better SEO control.
  * Added markdown support for image captions.
</Update>

<Update label="January 16, 2026" tags={["New releases","Improvements"]} rss={{ title:"install.md, live preview in the web editor, and more" }}>
  ## `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 colors with a refreshed color 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.
</Update>

<Update label="January 9, 2026" tags={["New releases","Improvements"]} rss={{ title:"Implicit snippets and assistant conversation insights for all" }}>
  ## 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](/create/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

  * **Tabs bottom border**: Added optional bottom border styling for tabs.
  * **Mermaid controls**: Interactive controls for [Mermaid diagrams](/components/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.
</Update>

<Update label="December 23, 2025" tags={["New releases","Improvements"]} rss={{ title:"Web editor improvements and assistant insights" }}>
  ## Web editor improvements

  The [web editor](/editor/index) now has a more intuitive interface and new capabilities.

  * **Visual navigation editing**: Configure your navigation structure in the web editor and see how your site's navigation sidebar looks in the editor. All changes map to your `docs.json` automatically.
  * **Configuration options**: Adjust all site configuration options from the editor without manually editing your `docs.json`.
  * **Drag-and-drop assets**: Drag images and files directly from your computer into the file tree to upload them.
  * **Improved stability**: Stability improvements and mobile responsiveness.

  ## Agent suggestions from assistant conversations

  The [agent](/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](/ai/slack-bot) directly from the dashboard.

  * **Choose a reply channel**: Select which channel the bot automatically replies to all messages in. The default is `#ask-ai`.
  * **Customize the bot's appearance**: Change the bot's avatar and name from your dashboard.

  ## Mobile navigation improvements

  * Added theme switcher to mobile navigation for easier light/dark mode toggling.
  * Added logo display to mobile navigation for better branding.

  ## Bug fixes

  * Fixed missing request examples in API playground for certain endpoints.
  * Fixed MDX examples not displaying correctly when using prefilled examples in the API playground.
  * Fixed links in assistant opening in new windows instead of the same window.
  * Fixed Markdown link rendering in assistant responses.
  * Fixed header slug character handling for special characters.
</Update>

<Update label="December 19, 2025" tags={["Improvements"]} rss={{ title:"Agent, assistant, and editor improvements" }}>
  ## Agent improvements

  * Added support for reading [custom instructions](/agent/customize) from an `AGENTS.md` file.
  * Agent now opens PRs under your GitHub account if you connect your account on the dashboard.

  ## Assistant improvements

  * Added copy conversation button to easily share or save assistant conversations.
  * Improved handling of stream stalled scenarios for more reliable assistant responses.
  * Improved assistant display on mobile devices.

  ## Web editor improvements

  * Added [shareable preview links](/editor/branching-and-publishing#access-and-share-a-preview) from the editor toolbar.
  * Updated [publishing workflow](/editor/branching-and-publishing) to support one-click publishing or creating pull requests.
  * Working in the web editor no longer requires you to sign in with GitHub.

  ## Onboarding improvements

  * Choose between a Mintlify-hosted documentation repository or using your own repository while signing up.
  * Create a documentation site without connecting a GitHub account.

  ## Snippet improvements

  * [Relative imports](/create/reusable-snippets#import-snippets-into-pages) are now supported for snippets.

  ## Localization improvements

  * Added support for Polish, Uzbek, and Hebrew languages.
  * UI elements in the API playground, including "Try it" and "Send" buttons, are now localized across all supported languages.
</Update>

<Update label="December 12, 2025" tags={["New releases","Improvements"]} rss={{ title:"Agent suggestions and Q&A bots" }}>
  ## 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](/ai/slack-bot). 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

  * **Insights** renamed to **Analytics** in the dashboard.
  * Added ability to delete a deployment from the dashboard.
  * The `Tooltip` component has been redesigned with improved styling and now supports an optional `headline` prop for adding a title to your tooltips.
  * The `mint a11y` command now supports `--skip-contrast` and `--skip-alt-text` flags, allowing you to run specific accessibility checks in your CI/CD pipeline. Use `--skip-contrast` to check only for missing alt text, or `--skip-alt-text` to check only color contrast ratios.

  ## Bug fixes

  * Fixed links inside tabs not working correctly.
  * Fixed heading levels 5 and 6 rendering in the web editor.
  * Fixed schema page examples display in API reference pages.
  * Fixed image upload paths in monorepo setups.
  * Fixed an issue where the incorrect request payload value was being selected first in the API playground.
  * Removed file extensions from default image titles when uploading.
  * Fixed double underline styling on banner links.
  * Fixed loading states and date range values for analytics page.
  * Folders in the web editor now properly maintain their open/closed state when other folders are opened or closed.
  * Fixed long API page titles overflowing instead of wrapping.
</Update>

<Update label="December 9, 2025" tags={["New releases"]} rss={{ title:"Preview widget",description:"Track changed files in preview deployments with an interactive widget" }}>
  ## 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:

  * One-click navigation to changed pages.
  * Searchable list of all changed files with status badges (added, modified, removed).

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

<Update label="December 8, 2025" tags={["New releases"]} rss={{ title:"Last modified dates",description:"Show when pages were last updated with automatic timestamps" }}>
  ## Last modified dates

  You can now display "last modified" timestamps on all pages in your documentation. Enable this feature by setting the [`timestamp`](/organize/settings-seo#metadata) 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.
</Update>

<Update label="December 5, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground enhancements, web editor improvements, and bug fixes" }}>
  ## Web editor improvements

  * Fixed image uploading from visual mode in the editor. Now images upload with correct paths and improved path resolution handles absolute and relative paths.
  * Fixed sync operation to properly update currently opened files so that the editor shows the most up-to-date content.
  * Improved branch fetching with automatic updates every 15 minutes.
  * Fixed branch creation workflow to correctly populate folder structure when creating new branches without moving uncommitted changes.
  * Fixed folder duplication issue when creating new branches.

  ## Assistant improvements

  * Fixed assistant submission to prevent empty messages from being sent.
  * Fixed accidental message submission during IME composition (for languages like Japanese, Chinese, Korean).
  * Better behavior when adding code snippets to assistant.

  ## Bug fixes and reliability

  * Fixed handling of complex Mermaid diagrams.
  * Fixed hash handling for URLs and table of contents to properly highlight the active page when accessing the root path with an index page.
  * Added ability to disable 404 page recommendations via configuration.
  * Fixed a bug in the API playground where boolean `false` and numeric `0` values in query parameters would be filtered out and not appear in the generated API request.
</Update>

<Update label="December 3, 2025" tags={["New releases"]} rss={{ title:"Assistant query bucketing",description:"Automatically group similar assistant queries to identify common user questions" }}>
  ## Assistant query bucketing

  [Assistant insights](https://app.mintlify.com/products/assistant) 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.
</Update>

<Update label="December 1, 2025" tags={["New releases"]} rss={{ title:".mintignore support",description:"Exclude files and directories from your published documentation" }}>
  ## .mintignore support

  * Added `.mintignore` file support to exclude specific files and directories from being processed and published to your documentation site.
  * Uses the same pattern syntax as `.gitignore` for familiar configuration.
  * Excluded files don't appear in published docs, aren't indexed for search, and aren't accessible to visitors.

  Learn more in the [.mintignore documentation](/organize/mintignore).
</Update>

<Update label="November 25, 2025" tags={["Improvements"]} rss={{ title:"Vale version upgrade",description:"Vale version 3.10+ now supported" }}>
  ## Vale version upgrade

  * Upgraded backend dependencies to use Vale version 3.11.2-r5, bringing native MDX support to the Vale CI check feature.
</Update>

<Update label="November 21, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground enhancements, localization updates, and CLI improvements" }}>
  ## API playground improvements

  * Fixed issue where response section would disappear when switching between endpoints with different response codes. The playground now properly resets to the first available response code when navigating to a new endpoint.
  * Fixed double "Authorization" header display in HTTP Basic authentication schemes. The authentication section now shows a cleaner interface with proper field labels and descriptions.
  * Improved handling of `oneOf` schemas in nested objects and arrays. Complex API schemas with multiple type options now render correctly as dropdowns instead of tabs in appropriate contexts.
  * Fixed missing path parameters that were defined at the endpoint level in OpenAPI specs. Parameters specified above individual operations are now properly included in both the main page and playground.
  * Enhanced response example generation to include all required properties, even when examples only specify some fields. This ensures response examples are complete and accurate.
  * Fixed missing prefill examples in object arrays. Array items with example data now properly populate in the playground with correct indexing.
  * Improved description padding and spacing throughout the API playground for better readability and visual consistency.

  ## Localization improvements

  * Enhanced translations in contextual menu options and assistant status messages for all supported languages.

  ## CLI improvements

  * Added error message for users running `mint dev` on Node.js versions below 20.17. Users are guided to upgrade to an LTS version.
</Update>

<Update label="November 15, 2025" tags={["New releases","Improvements"]} rss={{ title:"Weekly Updates",description:"Badge component, API playground improvements, custom language support, and performance enhancements" }}>
  ## New features

  * **Badge component**: New <Badge color="green">Badge</Badge> component for displaying status indicators, labels, and tags
  * **Custom Shiki languages**: Add support for custom programming languages in code blocks through `docs.json` configuration, enabling syntax highlighting for domain-specific languages
  * **Clarity analytics integration**: Microsoft Clarity is now available as an analytics integration for session recording and heatmap tracking

  ## API playground improvements

  * Authentication keys now persist in the API playground across page navigation and browser sessions, eliminating the need to re-enter credentials when testing multiple endpoints
  * Authentication keys are automatically prefilled from your configuration, making it faster to start testing authenticated endpoints
  * Fixed authentication header names for Bearer auth and OAuth to use correct HTTP standards
  * Security inputs defined at the operation level in OpenAPI specs now properly override top-level security definitions
  * Fixed issue where header inputs marked as security parameters were incorrectly included in generated code examples
  * Improved handling of `deepObject` style parameters in API field displays
  * Better error messages when invalid URLs are provided in API configurations
  * Improved UI for API playground with better spacing, layout, and loading

  ## Navigation and UI enhancements

  * Tab hover indicators now have improved styling for better visual feedback
  * Long words now wrap properly to prevent horizontal scrolling
  * Step component now handles cases where no step title is provided
  * Logo section spacing improved with better padding
  * Fixed heading IDs to properly handle question marks and special characters for anchor links
  * Icon component now accepts `className` prop for custom styling
  * Fixed theme toggle colors for better visibility in both light and dark modes

  ## Web editor improvements

  * Branch switching is now integrated directly into the editor UI for easier navigation between branches
  * Fixed file creation and renaming to properly match original file locations in MDX frontmatter
  * Fixed handling of moving files to previously deleted paths
  * Folder state now persists in the editor across sessions

  ## Component and styling enhancements

  * Images can now be zoomed with improved overlay styling for both light and dark modes
  * Fixed keyboard shortcut styles inside callouts for dark mode
  * Improved OG image generation with Google Fonts support and better truncation logic
  * Improved UI for tables with better alignment, spacing, and readability
  * Fixed scroll behavior for tables inside tabs and steps inside tabs
  * Improved sidebar styling for Palm theme

  ## Performance and infrastructure

  * Shiki themes are now lazy loaded for improved initial page load performance
  * Reduced navigation lag by optimizing prefetching behavior

  ## Bug fixes and reliability

  * Properly clear added values on object and array inputs in API playground
  * Fixed table of contents rendering issues
  * Fixed favicon isolation to prevent conflicts between different documentation sites
  * Fixed sidebar display on non-API pages
  * Fixed outline blinking on image zoom modal open/close
  * External links now properly open in new tabs
  * Fixed dashboard design inconsistencies and improved spacing
</Update>

<Update label="October 31, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground enhancements, table improvements, performance optimizations, and bug fixes" }}>
  ## Assistant improvements

  * **Starter questions for assistant are here! You can add your own within the dashboard at [Assistant --> Settings](https://app.mintlify.com/mintlify/mintlify/products/assistant/settings)**
  * Assistant insights quality has been improved with default spam protection for abusive keywords and JSON queries.

  ## API playground improvements

  * The API playground now automatically fills in default values for parameters, which saves time when testing endpoints.
  * Issues with `allOf`, `oneOf`, and nested object schemas that previously caused rendering problems or incorrect field displays have been fixed, and complex API schemas now render correctly with all fields visible and properly structured.
  * Enum and nullable field types now display accurate labels in the playground, which makes it clearer what values are accepted and whether fields are optional.
  * When working with nested objects in API requests, the playground now shows proper descriptive labels for each field instead of generic placeholders, which makes it easier to understand what data to provide.
  * Enum const tables and API field displays now render with improved formatting and alignment, which makes it easier to scan available options and understand field requirements.
  * API playground modals now display rich MDX-formatted descriptions at the top, which gives better context for endpoints with formatted text, links, and code examples.

  ## Analytics changes

  * Deferred analytics loading: PostHog and LogRocket now load after documentation content, which improves initial page load times and Core Web Vitals scores without affecting analytics data.
  * Conditional session recording: PostHog session recording can now be enabled conditionally based on user properties or page context for more control over when recordings happen.

  ## Visual improvements

  * Tables now have better alignment, consistent spacing, and enhanced readability. Headers align properly with their content columns.

  ## Bug fixes

  * Fixed link overflow issues that caused horizontal scrolling on mobile devices. Links now wrap properly within their containers.
  * Improved LaTeX/math block styling for better readability and consistent formatting.
  * Added `playsInline` and autoplay props to video embeds so they work correctly on iOS devices.
  * Updated Claude icon with proper border-radius for visual consistency.
  * Fixed `/llms.txt` routing so LLM agents can properly access documentation.
  * Prevented infinite schema expansion in complex OpenAPI specs that could cause browser crashes.
  * Removed x-overflow in Palm theme that was cutting off text in the API playground.
  * Increased content font-size to improve compatibility with browser reader modes.
  * Fixed Google login button styling for better visual consistency.
</Update>

<Update label="October 24, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Dashboard enhancements, API playground improvements, authentication fixes, and performance optimizations" }}>
  ## Insights improvements

  * Improved insights page with fixed date selectors for "today" and "yesterday"
  * Enhanced feedback table with improved search functionality
  * Added loading state for categories table

  ## Assistant improvements

  * Added assistant placement configuration in dashboard
  * Improved assistant responses with fixes to context fetching and tool messages

  ## API playground and OpenAPI enhancements

  * Refactored API playground endpoint fields to use new schema graph for better performance
  * Improved API examples display in playground modal even when assistant sidebar is open
  * Fixed props adjacent to `$refs` and `x-` props getting lost in OpenAPI parsing
  * Fixed API playground modal header styling

  ## Web editor and deployment enhancements

  * Restored manual create preview button for easier preview deployment creation
  * Added fetcher in dashboard for branch protections data
  * Added fetcher in dashboard for PR status tracking
  * Improved editor state management, enabling state to persist across browser sessions
  * Fixed disabled state for editor publish button
  * Removed code block background in editor for cleaner appearance

  ## Performance and infrastructure

  * Implemented full Git sync in the web editor for better repository synchronization
  * Cached MCP responses for improved performance
  * Improved sitemap to normalize `/index` paths

  ## Bug fixes and reliability

  * Fixed authentication prefill values not getting properly prefilled in API playground
  * Fixed custom meta tags from `seo.metatags` to survive client-side hydration
  * Fixed page header text overflow with `break-all` styling
  * Removed full width constraint for page size options
  * Fixed button size for accept organization invitations
  * Fixed keyboard shortcut display showing "Ctrl+I" without plus sign on non-macOS computers
</Update>

<Update label="October 17, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Assistant improvements, navigation enhancements, API playground updates, and bug fixes" }}>
  ## Assistant and AI improvements

  * Upgraded assistant prompt for better accuracy and context-aware responses
  * Added confidence scoring to improve decision-making in assistant responses
  * Enhanced assistant search with parallel documentation queries for faster results
  * Fixed assistant disappearing bug and improved visibility on small pages

  ## Navigation and UI enhancements

  * Added stable scrollbar gutter to navigation components for consistent layout
  * Made "On this page" section clickable to quickly scroll to the top of a page
  * Fixed assistant bar positioning across all themes
  * Improved assistant bar to prevent overlapping content
  * Fixed Almond theme wide page max-width
  * Enhanced dropdown arrow icon sizing for consistent navigation group appearance

  ## API playground and OpenAPI improvements

  * Added feature flag support for new API reference page design
  * Improved OpenAPI schema graph utilities to handle compositions properly
  * Added endpoint type to operation data for better API documentation
  * Fixed API playground description rendering when enum and table are in Markdown
  * Moved rendering of descriptions in API playground for better layout

  ## Bug fixes and reliability

  * Fixed locale switching to stay on the same page instead of redirecting to the home page
  * Fixed broken links CLI to exit with code 1 for CI/CD integration
  * Fixed local font paths to properly prepend forward slash
  * Fixed redirect handling to ignore leading slashes in `docs.json`
  * Fixed canonical URL stripping of `/index` for better SEO
  * Fixed ordered list positioning inside accordions
  * Fixed `<span>` tag styling to behave like `<p>` tags
  * Fixed display block for first `<p>` tag in lists
  * Fixed OG image display to show division name for index pages
  * Fixed icon paths to include `BASE_PATH` for relative paths
  * Fixed assistant background blur removal for better performance
</Update>

<Update label="October 11, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground improvements, analytics enhancements, web editor updates, and bug fixes" }}>
  ## Assistant and Agent AI features

  * Added list\_pull\_requests and list\_commits tools for agent such that it can document a date range of PRs or multiple PRs at once
  * Upgraded agent and assistant to Claude Sonnet 4.5
  * Improved assistant search to query docs in parallel for faster assistant responses
  * Fixed conversation length counting to exclude tool calls

  ## Insights improvements

  * Retitled analytics to insights
  * Removed click-to-load requirement for insights so you can see all your data immediately
  * Improved insights data accuracy with server-side timestamps

  ## Web editor and dashboard improvements

  * Removed background from code blocks in editor for cleaner appearance
  * Fixed branch creation workflow to correctly navigate to newly created branches
  * Added deployment history pagination
  * Added cursor pagination to preview deployments table
  * Fixed preview deployments to only return preview environment deployments
  * Improved dashboard UI/UX with better spacing, input handling, and layout fixes
  * Added better handling for links in dashboard assistant chat
  * Fixed outline issues for chat assistant in Firefox

  ## API playground enhancements

  * Improved rendering of API playground modals
  * Fixed API playground expandables not working with anchor links
  * Added support for merging example and user-inputted body in API playground
  * Fixed how video responses display in API playground

  ## Bug fixes and reliability

  * Fixed duplicate base paths and links in 404 recommended pages
  * Auto-populated og:url tag with appropriate canonical URL
  * Added canonical tag for better SEO
  * Fixed code block overscroll issues
  * Made search engines ignore preview deployments for SEO purposes
  * Fixed referrer tracking to use domain instead of full URL
  * Fixed images always becoming MDX block elements (kept inline images inline)
  * Removed comments in raw markdown pages such that you can use TODO comments without them leaking to users
  * Fixed directory reading support for read\_external\_files

  ## Component and styling

  * Added dropdowns support in products division
  * Fixed products and menu in middleware nav util function
  * Changed 404 page copy to be more clear
</Update>

<Update label="October 3, 2025" tags={["New releases","Improvements"]} rss={{ title:"Weekly Updates",description:"Products navigation, accessibility CLI, API playground enhancements, and extensive accessibility improvements" }}>
  ## New features

  * **Products navigation**: Organize documentation for multiple products with the product switcher navigation
  * **Accessibility CLI command**: Run `mint a11y` to test your docs for accessibility issues
  * **Video responses in API playground**: API playground now supports displaying video response types
  * **API playground prefill**: New option to prefill API playground examples for faster testing
  * **Unauthenticated feedback**: For sites using partial authentication, users can now submit feedback without being authenticated
  * **Shiki theme support**: Shiki themes are now supported for code block styling
  * **Twoslash for code blocks**: TypeScript and JavaScript code blocks now support Twoslash for inline type information

  ## Accessibility improvements

  * Added comprehensive ARIA attributes across components for better screen reader support
  * New "skip to main content" button for keyboard navigation
  * Arrow key navigation support in tab components
  * Enhanced tooltips, nested lists, and code group accessibility
  * Improved focus states and keyboard interaction patterns throughout the UI

  ## Assistant and analytics enhancements

  * Added bar chart visualization for assistant query analytics
  * Unified date range picker in assistant analytics page
  * Zoom controls for assistant analytics charts
  * Better assistant history management with hotkeys and chat sheet improvements

  ## Bug fixes and reliability

  * Fixed z-index issues with side panel overlays
  * Fixed light mode color fallbacks and theme-related styling bugs
  * Fixed API playground expandables not working with anchor links
  * Fixed `.md` link accessibility for ChatGPT and other LLM agents
  * Fixed image dimension handling for percentage-based widths and heights
  * Fixed code block rendering issues with language tags and custom themes
  * Fixed accordion link formatting and styling
  * Fixed footer spacing when assistant configuration is empty
  * Fixed card icon rendering for local repository images
  * Fixed audio file handling in API playground (prevented UTF-8 decoding)
  * Improved PR publish state management in web editor
</Update>

<Update label="September 26, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Language support expansion, UI improvements, and infrastructure enhancements" }}>
  ## Language support expansion

  * Added support for Romanian and Czech languages in the documentation interface
  * Enhanced localization capabilities with complete translation coverage for new languages
  * Improved language selector functionality across all themes

  ## UI and user experience improvements

  * Fixed tab visibility issues on 404 pages to prevent incorrect active tab highlighting
  * Enhanced image handling with proper width and height attribute passing for non-optimized images
  * Improved 404 page layout and styling consistency

  ## Infrastructure and performance enhancements

  * Enhanced GIF image processing by skipping costly Imgix auto-formatting to reduce processing time and bandwidth usage
  * Optimized image serving performance with special handling for animated content

  ## Bug fixes and reliability

  * Fixed contact email routing in dashboard settings for Assistant add-on requests
  * Enhanced database schema updates for better user management
</Update>

<Update label="September 19, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Web editor and authentication improvements, and bug fixes" }}>
  ## Web editor and dashboard login improvements

  * Continued app router migration for the web editor, removing blockers and improving performance
  * Enhanced login error handling with explicit email validation messages
  * Fixed whitespace handling in email address validation

  ## Authentication improvements

  * Added support for validated redirect parameters in login callback to reduce login friction
  * Improved login flow for SSO with better redirect handling

  ## Bug fixes and reliability

  * Fixed GitLab integration issues with larger repositories
  * Improved dashboard loading performance with optimized deployment queries
  * Fixed SVG path rendering issues in documentation
  * Fixed keyboard navigation in search and chat functionality
</Update>

<Update label="September 13, 2025" tags={["New releases","Improvements"]} rss={{ title:"Weekly Updates",description:"AI 404 suggestions, assistant web search with external sources, security enhancement, and reliability fixes" }}>
  ## Major releases

  * **Major enhancement**: AI suggested pages on 404 pages, [when someone hits a dead link → AI agent reads the path → suggests semantically similar pages](https://x.com/mintlify/status/1966625627773059495)
  * **Major release**: web search for assistant can now include external sources\
    *Note: Contact us to enable this feature for your site.*

  ## Assistant and MCP

  * Fixed a bug where the assistant would be incorrectly rate limited due to time window not sliding correctly
  * Fixed a bug with assistant tool calling to properly handle empty `text` blocks
  * Fixed a bug where MCP server names concatenated with tool calls were sometimes exceeding the 60 character length MCP clients enforce
  * Fixed a bug where the assistant menu would have a height several times larger than the viewport and scroll forever
  * Fixed a bug where assistant spend values could display with greater than two decimal places in the dashboard

  ## Web editor and deployments

  * Security enhancement added to editor such that only users with `write permissions` for the connected git hosting repository can make changes
  * Fixed a bug where preview deployments wouldn't work for branches with `=` in the name
  * Fixed a bug where long branch names would overflow modals on preview deployment creations
  * Quality of life improvement where email query parameter will prefill the input on signup invitations
  * Fixed a bug where copying a page from the context menu was not working on safari

  ## API playground and navigation

  * Multiple API playground response codes now display in a controlled styled select menu instead of the system default select menu when focused
  * You can now use the [`expanded field on navigation groups in your docs.json to make them be default open`](https://mintlify.com/docs/navigation#default-expanded-state)

  ## SEO and UI

  * Fixed a bug where favicons were not showing up in search engines by serving them from the same URL as the documentation site itself for each respective site
  * Fixed a bug where youtube embeds would flash in and out on load
  * Fixed a bug where expanding the feedback menu to include written responses would cause layout shift with the table of contents
  * Fixed a bug where text would leak above the topbar on the maple theme when a user dismissed the notification banner
  * Enhanced the Maple and Willow themes by adding login/logout buttons to the sidebar for easier access

  ## Analytics and exports

  * Fixed reliability issues with assistant analytics view and exports
  * Assistant analytics exports are now executed in the background and sent via email for a more reliable experience
</Update>

<Update label="August 30, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Enhanced feedback collection, navigation improvements, and authentication bug fixes" }}>
  ## Major release: Enhanced feedback collection

  * **Major improvement**: Readers can now give more detailed feedback after selecting *thumbs up/down*, including options and written comments. You can also collect feedback on code blocks and view all responses in your dashboard analytics.\
    *Note: Contact us to enable this feature for your site.*

  ## Navigation and quality of life improvements

  * Quality of life improvement to ignore trailing slashes and double slashes so you don't have to worry about getting them exactly right in your docs.json
  * You can now add a `noAnchor` attribute to your `h1-6` HTML tags to avoid them having an anchor link
  * The Palm theme now has a floating language selector in the bottom left similar to Stripe's approach
  * Added a new field to the docs.json called [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) which allows you to control whether or not users are navigated to the first page in a navigation group when the group is expanded
  * Quality of life improvement to make nested ordered lists alternate styles from decimal/Roman to alpha

  ## Bug fixes and reliability

  * Fixed a bug where scroll position anchor links weren't working correctly when there were JS components on a page
  * Fixed a bug where Google was indexing raw `*.md` files because they were missing a `x-robots-tag noindex` header
  * Fixed a bug with OAuth on protected docs where it wouldn't redirect you back to your starting page once you completed the flow successfully
  * Fixed a bug on previews of auth protected docs where you weren't able to see the entire navigation bar
  * Bug fixes to how SVGs are handled with our new image CDN

  ## Component and styling enhancements

  * Added a new CSS selector for custom styles on `SidebarNavGroupDivider`
  * New regression tests for MDX defined API pages that have security defined on them will ensure a greater degree of stability

  ## Performance improvements

  * Performance improvement by moving the KaTeX CSS from cdnjs to our own CDN on Cloudfront for reduced latency
</Update>

<Update label="August 23, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Image layout fixes, auth enhancements, mobile nav improvements, and web editor stability" }}>
  ## Image handling improvements

  * **Major improvement**: Images no longer cause layout shift by default, even when width and height attributes aren't specified—automatic sizing prevents content jumping during page loads
  * All static files in your repository (PDF, TXT, XML, etc.) are now automatically uploaded and served when you deploy, providing complete asset coverage

  ## Web editor and deployment enhancements

  * Fixed branch creation workflow in web editor to correctly navigate to and stay on newly created branches
  * Enhanced merge conflict dialog with proper escape functionality, no more page reloads required to dismiss conflicts
  * Optimized update workflow performance by cache-invalidating only changed pages during partial updates, reducing deployment times

  ## Authentication and navigation improvements

  * New support for authentication on custom subpaths, if you serve docs at `https://yourdomain.com/docs`, authentication now works seamlessly
  * Fixed sidebar display bug that incorrectly showed when only one link was configured
  * Comprehensive mobile navigation overhaul: centered buttons with proper margin/padding, improved spacing in dropdown menus, removed unnecessary dividers and margins for empty sections, and fixed Maple theme gap/padding issues

  ## Component and styling fixes

  * Resolved `<h1-6>` tag conversion issue that was incorrectly transforming them into Heading components and disrupting custom styling
  * One-click assistant configuration toggle added to dashboard for easier management

  ## Technical improvements and reliability

  * Enhanced logging system for update workflows enabling faster debugging and issue resolution
  * Fixed GitHub rate limiting for customers with 10+ OpenAPI/AsyncAPI specs by switching from individual file fetching to repository cloning
  * Improved assistant reliability with backup LLM support, enhanced rate limit error handling, and more robust search tool functionality
</Update>

<Update label="August 16, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Performance optimizations, LLM integrations, web editor polish, and API playground enhancements" }}>
  ## Performance and build optimizations

  * MDX transpilation now happens at deployment time instead of on every page load in uncached NextJS serverless environments, improving time to first byte for uncached pages.
  * Content-based hashing prevents re-transpilation when MDX hasn't changed, reducing update workflow times by \~50% for customers with large page counts (deployments over 5 minutes should be roughly halved)
  * Preview deployment viewing in the dashboard is now faster with added database indexes and query parallelization in our backend
  * Reduced page size by eliminating duplicate `navigation` data in each page's `rsc` payload—performance gains most noticeable with high page counts or complex navigation structures
  * More aggressive prefetching enables instant page loads more frequently

  ## API playground and OpenAPI enhancements

  * OpenAPI to MCP conversion moved to backend, enabling hosted MCP servers to contain tools (expect clearer documentation and config options soon)
  * Added Ruby support to API playground
  * We added a feature such that you can now [specify API pages using just your docs.json](/api-playground/openapi-setup#auto-populate-api-pages) without creating any new mdx files.
  * Support for [`webhook pages`](/api-playground/openapi-setup#webhooks) in docs navigation from OpenAPI specs
  * Optimized AI model context by removing anchor link specifications from markdown links when navigating to Anthropic, OpenAI, or other providers

  ## Web editor improvements

  * File creation/renaming now saves changes when clicking away instead of requiring Enter key press
  * Fixed branch navigation where changing URL to specific branch would redirect to last active branch instead of intended destination
  * Properly URL encode branch titles containing `/` to prevent navigation breakage
  * Fixed `Ctrl+K` link shortcut in monorepo dashboard Editor that was prepending docs repo path and creating broken links

  ## Analytics and LLM integrations

  * Custom `llms.txt` and `llms-full.txt` support—add to docs repo root to serve at `/llms.txt` and `/llms-full.txt` endpoints for LLM customization
  * Added [Hightouch analytics integration](/integrations/analytics/hightouch)
  * Enhanced context menu analytics tracking (dashboard viewing coming soon)
  * Added e2e tests for `llms.txt` and `llms-full.txt` to ensure correct serving

  ## Component and styling enhancements

  * Support for custom classnames in `h{1-4}` tags for applying custom heading styles
  * Fixed `h{1-4}` tags rendering as `Heading` components with chips in custom page mode
  * Added CSS selectors to [breadcrumbs](/organize/navigation#breadcrumbs) for custom CSS targeting
  * Fixed stretched open-graph images by analyzing dimensions to maintain proportions at 56px height
  * Corrected `VSCode` to `VS Code` in contextual menu when enabled
  * Fixed headings within custom components appearing in table of contents alongside semantic headings

  ## Bug fixes and reliability

  * Fixed PDF render issues with certain page titles by sanitizing characters that cause generation problems
  * Resolved CLI error `Cannot convert undefined or null to object` when encountering empty OpenAPI JSON files
  * Fixed custom `docs.json` open-graph metatags being overwritten by generated ones
  * Fixed RSS feed button clicks when landing on anchor links by using origin + pathname for RSS links
  * Improved CLI download speed by removing sourcemaps

  ## Technical improvements

  * Added visual tests to CI pipeline for earlier regression detection
  * Enhanced error handling and debugging capabilities
  * Comprehensive testing coverage for new features and edge cases
</Update>

<Update label="August 9, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Search API, OAuth polish, asset serving, and MCP tooling" }}>
  ## Authentication improvements

  * Group-level public access: make entire page groups public via `docs.json` so you don’t need `public: true` on each page ([learn more](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level))
  * Support [`logoutURL in OAuth configuration`](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) to delete upstream cookies and complete sign-out
  * On OAuth errors, users are redirected to your specified `logoutURL` to restart the auth flow
  * Fixed a flash of a 500 error during OAuth/JWT flows before the callback
  * Auto-strip `https://` from URLs in OAuth/JWT auth configuration to prevent misconfiguration

  ## API playground enhancements

  * New [Search API endpoint](https://mintlify.com/docs/api-reference/assistant/search) so you can build agents and MCP servers on top of your docs
  * `openapi` and `asyncapi` files are now served at their specified paths (for example, `https://mydocsurl.extension/{openapi-or-file-name}.json`)
  * You can now use the [`x-mint field in your openapi files`](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) to override generated fields, customize preface content, or change endpoint URLs in code samples
  * [`x-mcp is now x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) in OpenAPI configurations to control which routes are exposed as MCP tools

  ## Assistant updates

  * Fixed an issue where the action menu (containing options like copy and thumbs up) for older messages disappeared when new ones streamed in
  * Fixed accessibility of nested `/mcp/...` pages after the [hosted MCP servers release](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) from last week

  ## Performance and reliability

  * All image and video assets present in your docs repo are now served at the appropriate path on your domain. For example, if you have `/assets/marketing/my-logo.png` in your repo, it will be available at `https://mydocsurl.extension/assets/marketing/my-logo.png`.
  * Email field on login for the Mintlify dashboard now autofocuses so you can start typing immediately *(quality of life improvement)*
  * Both custom domains and subdomains in Redis for a performance improvement on navigation load times (\~50ms latency reduction)
  * Added retry logic for PDF exports to improve reliability
  * Fixed cookie consent popup reappearing after acceptance or dismissal—first selection is now respected
  * Fixed copying a page to clipboard on Safari by specifying a MIME `type` in `navigator.write`

  ## Technical improvements

  * CLI bugfixes for windows and pnpm, plus CI tests to prevent regressions
  * Improved error logging output—a quality of life upgrade for our engineering team when debugging
  * Minor fixes to the broken-link CI action when `contentDirectory` files are missing
  * Fixed a regression caused by the auth-protected preview fixes from last week where the active tab was not being set correctly in the navigation UI
  * Fixed theme light background color not being applied to active tab icons
  * Fixed an issue where changing the auth type in the dashboard would update and then flip back to the previously saved type—now the new selection persists after saving
  * Internal DX improvements for enterprise customers with custom UI libraries—it's now easier for us to include your components and accommodate requests on shorter timelines
</Update>

<Update label="August 2, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Authentication improvements, search enhancements, and assistant API" }}>
  ## Authentication improvements

  * Local development improvements to auth, enabling faster development of auth features and bug fixes in this product area
  * Preview deployments now available for auth-protected sites
  * Fixed redirect behavior to properly return users to their original page after authentication
  * Fixed logout button display for full authentication (previously only worked for partial authentication)

  ## API playground enhancements

  * Fixed `multipart/form-data` file upload functionality in the API playground
  * Fixed anchor link behavior so clicking them updates the URL without scrolling to top of page
  * Fixed anchor link issues in nested tabs

  ## Assistant updates

  * New Assistant API so you can build it into your own products, compatible with AI SDK
  * Added copy button to chat responses
  * Fixed issue with retrying messages in the assistant
  * Improvements to default assistant prompt to make it less verbose by default

  ## Performance and reliability

  * Made search feel more crisp and accurate by aborting debounced requests as you type
  * Resource provisions for a new CDN - expect image asset and page load times to improve soon
  * Fixed bugs for rendering complex Mermaid diagrams like GANTT charts
  * Fixed CLI bugs on Windows to improve stability and added tests to prevent regression

  ## Technical improvements

  * Added OpenTelemetry for traces in NextJS application to improve time to first byte for customers
  * Migrated from Octokit to GitHub API Client to improve latency in the web editor experience
  * Fixed duplicate meta tags for OpenGraph
  * Upgraded MongoDB from version 6 to 7 for improved performance and new features
</Update>

<Update label="July 2025" tags={["New releases","Improvements"]} rss={{ title:"July Product Updates",description:"Slack app integration, hosted MCP servers, Cursor integration, and performance improvements" }}>
  ## Slack app

  * Zero friction access: Bot responds to DMs, @mentions, and any question in your `#ask-ai` channel
  * One-click setup: Install directly from your Mintlify dashboard in seconds
  * Contextual answers: Searches your entire documentation to provide relevant, accurate responses
  * Deflect support interruptions: Turn daily questions into instant, self-serve answers

  Learn more in our [Slack bot guide](/ai/slack-bot).

  ## 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](/ai/model-context-protocol).

  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](/ai/contextual-menu) for more information.

  ## Code block improvements

  * Improved syntax highlighting
  * Added more customization options including focus mode, expandable code blocks, dark and light mode responsiveness, language dropdown menu, line numbering, and icons
</Update>

<Update label="June 2025" tags={["New releases","Improvements"]} rss={{ title:"June Product Updates",description:"AI assistant updates and subscribable changelogs" }}>
  ## AI assistant updates

  * Improved accuracy through agentic RAG with tool calling
  * Provides navigable links to referenced pages so that users can go directly to the source of answers
  * Copy shortcut for code examples generated by assistant
  * "Ask AI" shortcut on code blocks in documentation to generate explanations from the assistant

  Learn more in the [assistant docs](/assistant/index).

  ## Subscribable changelogs

  * Automatically generate an RSS feed from changelog pages
  * Integrate RSS-enabled updates with Slack, email, and other tools

  Learn more in our new [Changelog guide](/create/changelogs)
</Update>

<Update label="May 2025" tags={["Improvements"]}>
  ## API playground stability updates

  * Search to find an endpoint
  * Indicate a deprecated endpoint with a tag
  * Hide auto-generated API pages from navigation
  * Upload multipart or form data files

  Learn more at [API playground docs.](/api-playground/)

  ## `mint update`

  Can now use `mint update` to update your CLI.
</Update>

<Update label="April 2025" tags={["New releases","Improvements"]}>
  ## Web Editor 3.0

  <Frame>
    <img src="https://mintcdn.com/mintlify/TcGu3ccxDpo8vh9U/images/webeditor3.jpeg?fit=max&auto=format&n=TcGu3ccxDpo8vh9U&q=85&s=1a0e1ce1db4d3b6bf7832ee20406ce8b" alt="Webeditor3 Jpe" width="3240" height="3240" data-path="images/webeditor3.jpeg" />
  </Frame>

  Overhauled usability in the WYSIWYG editor.

  **Major improvements**

  * Search for filenames using ⌘ + P shortcut
  * Pages load 10x faster
  * Faster load times when searching for a branch
  * Page options tab to configure layout, title, & metadata for SEO
  * Floating toolbar when you highlight text

  **Additional fixes**

  * Fixed top margin for changelog components
  * Improved reliability of right click behavior
  * After clicking publish, you’ll stay on the same page instead of being brought to an empty state
  * Standardized colors in file icons
  * Improved reliability after selecting new branches several times in a row
  * Removed Diff mode
  * More consistency when creating a new folder from the dropdown
  * Fixed block quotes creating more block quotes when trying to deselect

  ## AI Translations in beta

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/translations.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=655f5c32e66f402026a54881442b8305" alt="AI Translations graphic" width="995" height="611" data-path="images/changelog/translations.png" />
  </Frame>

  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.](customize/react-components)
</Update>

<Update label="March 2025" tags={["New releases","Improvements"]}>
  ## MCP server generator

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/mcpgenerator.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=9a6ad291fbcaaf5fafc5a5a54a6b020b" alt="screenshot of MCP server generator" width="1200" height="675" data-path="images/changelog/mcpgenerator.png" />
  </Frame>

  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.](/ai/model-context-protocol)

  ## Improvements

  * Tag changelog updates so end users can filter updates
  * Sonnet-3.7 supported for AI Chat. Configure your preferred model through the dashboard
  * Change your deployment name directly in dashboard settings

  ## Bug fixes

  * OG images fixed
  * 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
</Update>

<Update label="February 2025" tags={["New releases","Improvements"]}>
  ## New configuration schema `docs.json`

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/docsjson.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=63fc86877606ea18103ea7eb0a287dc3" alt="docs.json screenshot" width="1200" height="630" data-path="images/changelog/docsjson.png" />
  </Frame>

  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](https://mintlify.com/blog/refactoring-mint-json-into-docs-json).

  Upgrade from `mint.json` to `docs.json` with the following steps:

  1. Make sure your CLI is the latest version

  ```bash theme={null}
  npm i mint@latest -g
  ```

  1. In your docs repository, run

  ```bash theme={null}
  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](deploy/ci).

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

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/themes.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=b27f24b3138064d256eb5d4bf151de4a" alt="graphic with text &#x22;Themes v2&#x22;" width="1200" height="630" data-path="images/changelog/themes.png" />
  </Frame>

  New [pre-built themes](customize/themes) to modify the look & feel of your docs. Configure via your [docs.json file](organize/settings).

  Now available:

  * Maple
  * Palm
  * Willow

  ## Other improvements

  * [Guide to Technical Writing:](https://mintlify.com/guides/introduction) Best practices for writing technical documentation, including audience research, content types, and writing tips.
  * [Dropdown component](organize/navigation#dropdowns): Organize navigation with a dropdown, in addition to tabs and anchors.
  * [AI syntax fixer](https://x.com/ricardonunez_io/status/1892334887644123192): The web editor will catch if there’s a parsing error and use AI to suggest fixes.
</Update>

<Update label="January 2025" tags={["Improvements"]}>
  ## AI Assistant Improvements

  * New UI with dedicated chat page & pre-filled prompts
  * Stability improvements. For example, bug fixes of editing the wrong file or no files at all
  * More robust knowledge for adding & editing components
  * Improved `docs.json` file editing

  ## 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](/api-playground/). Updates include:

  * Easier detail expansion for an overview of a field
  * More intuitive nested design. For example, adding or deleting items
  * Faster response times

  ## Quality Improvements

  * Support for requiring authentication to access preview deployments
</Update>

<Update label="December 2024">
  ## Authentication

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/authentication.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=8ccc5ffdd641bcae823e1fe38b47301f" alt="Authentication screenshot" width="1200" height="630" data-path="images/changelog/authentication.png" />
  </Frame>

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

<Update label="November 2024">
  ## AI Writer

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/ai-assistant.jpg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=5feefba79cec6b665ee88ac2f80f5b25" alt="AI Assistant" width="1280" height="800" data-path="images/changelog/ai-assistant.jpg" />
  </Frame>

  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](/deploy/gitlab) to get started.

  ## Web Editor

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/webeditor.jpg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=26ea32fc35ac8f432d4a3861fc2c4bba" alt="Web Editor" width="5760" height="3520" data-path="images/changelog/webeditor.jpg" />
  </Frame>

  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](/editor).

  ## /llms.txt support

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/llms.jpg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=60828382c88fd24d464b5c2cae759760" alt="llms.txt support" width="1200" height="630" data-path="images/changelog/llms.jpg" />
  </Frame>

  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.](https://llmstxt.org)

  ## 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

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

<Update label="October 2024">
  ## Changelogs

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

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/changelog.jpg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=94d2c26b046b4e3dd2dae543021ba410" alt="Changelog" width="4800" height="2520" data-path="images/changelog/changelog.jpg" />
  </Frame>

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

  ```javascript Line Highlighting Example highlight={1,3-5} theme={null}
  const greeting = "Hello, World!";
  function sayHello() {
    console.log(greeting);
  }
  sayHello();
  ```

  ````mdx theme={null}
  ```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`:

  ```json theme={null}
  "codeBlock": {
    "mode": "auto"
  }
  ```

  ## Advanced Footer

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/advanced-footer.gif?s=37230f2a6cad69fdcbcba0352db56ffd" alt="Advanced Footer" width="1040" height="720" data-path="images/changelog/advanced-footer.gif" />
  </Frame>

  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](mailto:support@mintlify.com) if you'd like to customize the prompts.

  ## Dashboard Improvements

  * Added ability to change custom domain to be /docs directly through dashboard settings.
  * Consolidated the login and signup pages to decrease friction and confusion.
  * Implemented the discovery login flow so that users that are members of multiple organizations can now switch between them.
  * Added login with Google OAuth
  * Added ability to add new deployment through dashboard settings.

  ## Bug Fixes

  * Can now use leading slashes in navigation.
  * Can now edit CSS & JS files in the web editor.
  * Fixed `suggestEdit` not showing up even when enabled.
  * Fixed keyboard navigation for Search and Chat such that you can now use the up and down arrow keys to navigate the results.
  * Don't allow search engines to crawl user-auth protected pages.
  * Revalidate the cache when an org is deleted.
  * We now use the Scalar OpenAPI parser to parse OpenAPI definitions which improves the performance, fixes parsing issues, and surfaces better error messages.
  * Top-level descriptions are now supported in API reference pages autogenerated from OpenAPI definitions.
  * Add in-line-style support for icons
  * 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.
</Update>

<Update label="September 2024">
  ## Custom Fonts

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/custom-fonts.jpeg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=dea37048248a6a332803123b30893d7c" alt="Custom Fonts" width="2048" height="1075" data-path="images/changelog/custom-fonts.jpeg" />
  </Frame>

  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](/components/cards#image-cards).

  ## Update Speed Performances

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/performance-improvements.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=420764afe13643dd0641398671be2c4e" alt="Performance Improvements" width="1800" height="945" data-path="images/changelog/performance-improvements.png" />
  </Frame>

  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

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/seo-improvements.jpeg?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=e7e647e7cde063a0ff9021a2ca8533e7" alt="SEO Improvements" width="2048" height="1075" data-path="images/changelog/seo-improvements.jpeg" />
  </Frame>

  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

  * App router migration in the dashboard.
  * Search analytics are now available in the dashboard.
  * Delete an org functionality has been added to the dashboard.
  * Shipped GitLab connection UI.
  * Fix incorrect analytics data.
  * Add-on's can now be directly purchased through the dashboard.

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

  ## More

  * **Troubleshooting for API pages**: API pages could be complicated so we listed common issues to help you sort them out quickly — [Read the docs](/api-playground/troubleshooting)
</Update>

<Update label="August 2024">
  ## OpenAPI Reference Pages

  * Endpoints defined by OpenAPI that are complex and recursive are now 98% smaller.
  * We now show [additionalProperties](https://swagger.io/docs/specification/data-models/dictionaries/) in OpenAPI 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.

  * [Learn more about API configurations](organize/settings#api-configurations)

  ## 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

  * Fixed a bug for the Segment integration functionality.
  * We now raise more granular error messages for GitHub permissions when interacting with the editor.
  * Fixed bugs where the navigation would not properly expand when a direct link was used.
</Update>

<Update label="July 2024">
  ## AI Widget

  <Frame>
    <img src="https://mintcdn.com/mintlify/WXXCCJWDplNJgTwZ/images/changelog/widget.png?fit=max&auto=format&n=WXXCCJWDplNJgTwZ&q=85&s=09c9ba11ff9770523085eeda1d1e4f9d" alt="AI Widget" width="1548" height="1021" data-path="images/changelog/widget.png" />
  </Frame>

  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.

  * [Read the blog announcement](https://mintlify.com/blog/widget)

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

<Update label="June 2024">
  ## Launch Week Highlights

  * Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your `docs.json` file and it'll update your docs styling.
  * Search V2: directly query OpenAPI endpoint descriptions and titles to reach API Reference pages, remove hidden pages from search, and enjoy our updated search bar UI.
  * Web Editor branching: create branches in our web editor without an IDE.
  * User Personalization: authenticate users with Shared Session or JWT so that you can show them customized content, such as pre-filling API keys or showing specific content for customers.
  * OpenAPI Automation Upgrades: to auto-populate API Playground pages, you can add an `openapi` field to an object in tabs or anchors arrays in the `docs.json`.
</Update>

<Update label="May 2024">
  ## Okta SSO

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

  ## Mintlify REST API

  Programmatically trigger updates to your documentation.
</Update>

<Update label="April 2024">
  ## Custom mode

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

  * Create a custom global landing page setup with custom components
  * Add full-screen videos or image galleries
  * Embed custom iFrame demo elements to add intractability to your docs

  Check out our [Custom Mode docs](organize/pages#custom).
</Update>

<Update label="March 2024">
  ## Mintlify MDX for VSCode

  Call snippets of our pre-built components and callouts without leaving VSCode. [Install the extension here](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets).
</Update>

<Update label="February 2024">
  ## Quality Improvements

  * Dashboard upgrades: view update logs to see what's changed and status of an update, toggle between Mintlify projects to manage deployments
  * Versioning with tabs fully supported
  * Wildcard redirects now supported
  * CLI Error Detection: we now show the position of invalid frontmatter when there are parsing issues during local development
</Update>

<Update label="January 2024">
  ## 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.
  * Snippets V2: We now support fully reusable components and variables for snippets.
  * 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](https://github.com/mintlify/mdx) 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.
</Update>


## Related topics

- [Update](/docs/components/update.md)
- [Create developer documentation](/docs/guides/developer-documentation.md)
- [Changelogs](/docs/create/changelogs.md)