mintlify · handotdev · Sep 16, 2025
diff --git a/changelog.mdx b/changelog.mdx
@@ -18,7 +18,7 @@
 - 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 name's 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
@@ -26,7 +26,7 @@
 - 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
@@ -36,8 +36,8 @@

 ## 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 dismissed the notification banner
 - Enhanced the Maple and Willow themes by adding login/logout buttons to the sidebar for easier access 
@@ -70,7 +70,7 @@
 - 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

@@ -79,7 +79,7 @@

 ## Performance improvements

 - Performance improvement by moving the KaTeX CSS from cdnjs to our own CDN on Cloudfront for reduced latency

 </Update>

@@ -119,11 +119,11 @@

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

@@ -138,7 +138,7 @@
 - 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

@@ -149,7 +149,7 @@

 ## 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](/navigation#breadcrumbs) for custom CSS targeting
 - Fixed stretched open-graph images by analyzing dimensions to maintain proportions at 56px height
@@ -160,9 +160,9 @@

 - 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

@@ -179,7 +179,7 @@
  - 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

@@ -196,7 +196,7 @@
  ## 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
@@ -204,7 +204,7 @@

  ## 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
@@ -235,7 +235,7 @@

  ## 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
@@ -243,7 +243,7 @@
  ## 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>
@@ -251,7 +251,7 @@
 <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
@@ -270,17 +270,17 @@
  - 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](/guides/assistant).

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

@@ -367,7 +367,7 @@
  - 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"]}>
@@ -398,9 +398,9 @@

  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](settings/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

@@ -418,7 +418,7 @@
   ## 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](navigation#dropdowns): Organize navigation with a dropdown, in addition to tabs and anchors.
+  - [Tab component](navigation#tabs): Organize navigation with tabs and anchors for better user experience.
   - [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>
 
@@ -482,7 +482,7 @@
  <Frame>
    ![llms.txt support](/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

@@ -554,7 +554,7 @@
  ## 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.
@@ -568,7 +568,7 @@
  - 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.
@@ -601,7 +601,7 @@
  <Frame>
    ![SEO Improvements](/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

@@ -635,7 +635,7 @@

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

@@ -668,7 +668,7 @@
  </Frame>
  For `Pro` users, we introduced Mintlify Widget, an extension of your docs to
  answer your users' questions when and where they asked. You can add this
  AI-powered chatbot to any web page: your landing page, inside your product, or
  on your existing documentation pages.

  - [Read the blog announcement](https://mintlify.com/blog/widget)
@@ -703,7 +703,7 @@
 <Update label="May 2024">
  ## Okta SSO

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

  ## Mintlify REST API

@@ -726,7 +726,7 @@
 <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">
@@ -735,7 +735,7 @@
  - 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">

diff --git a/navigation.mdx b/navigation.mdx
@@ -95,7 +95,7 @@

 ### Default expanded state

 Set `expanded: true` on a group to make it expanded by default in the navigation sidebar. This is useful for highlighting important sections or improving discoverability of key content.

 ```json
 {
@@ -157,7 +157,7 @@
 
 ### Menus
 
-Menus add dropdown navigation items to a tab. Use menus to help users go directly to specific pages within a tab.
+Menus add sub-navigation items to a tab. Use menus to help users go directly to specific pages within a tab.
 
 In the `navigation` object, `menu` is an array where each entry is an object that requires an `item` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
 
@@ -274,52 +274,6 @@
 }
 ```
 
-## Dropdowns
-
-Dropdowns are contained in an expandable menu at the top of your sidebar navigation. Each item in a dropdown directs to a section of your documentation.
-
-<img
-  className="block dark:hidden pointer-events-none"
-  src="/images/navigation/dropdowns-light.png"
-/>
-
-<img
-  className="hidden dark:block pointer-events-none"
-  src="/images/navigation/dropdowns-dark.png"
-/>
-
-In the `navigation` object, `dropdowns` is an array where each entry is an object that requires a `dropdown` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
-
-```json
-{
-  "navigation": {
-    "dropdowns": [
-      {
-        "dropdown": "Documentation",
-        "icon": "book-open",
-        "pages": [
-          "quickstart",
-          "development",
-          "navigation"
-        ]
-      },
-      {
-        "dropdown": "API reference",
-        "icon": "square-terminal",
-        "pages": [
-          "api-reference/get",
-          "api-reference/post",
-          "api-reference/delete"
-        ]
-      },
-      {
-        "dropdown": "Blog",
-        "href": "https://external-link.com/blog"
-      }
-    ]
-  }
-}
-```
 
 ## OpenAPI
 
@@ -465,7 +419,7 @@
 
 ## Nesting
 
-You can use any combination of anchors, tabs, and dropdowns. The components can be nested within each other interchangeably to create your desired navigation structure.
+You can use any combination of anchors and tabs. The components can be nested within each other interchangeably to create your desired navigation structure.
 
 <CodeGroup>
 
@@ -616,7 +570,7 @@
 ```json
 {
   "interaction": {
-    "drilldown": true  // Force navigation to first page when a user expands a dropdown
+    "drilldown": true  // Force navigation to first page when a user expands a navigation group
   }
 }
 ```

diff --git a/settings.mdx b/settings.mdx
@@ -15,7 +15,7 @@

 To get started, you only need to specify `theme`, `name`, `colors.primary`, and `navigation`. Other fields are optional and you can add them as your documentation needs grow.

 For the best editing experience, include the schema reference at the top of your `docs.json` file. This enables autocomplete, validation, and helpful tooltips in most code editors:

 ```json
 {
@@ -393,21 +393,21 @@
           </Expandable>
         </ResponseField>
 
-        <ResponseField name="dropdowns" type="array of object">
-          Dropdown menus for organizing related content.
+        <ResponseField name="tabs" type="array of object">
+          Tab navigation for organizing content into distinct sections.
 
-          <Expandable title="Dropdowns">
-            <ResponseField name="dropdown" type="string" required>
-              Display name of the dropdown.
+          <Expandable title="Tabs">
+            <ResponseField name="tab" type="string" required>
+              Display name of the tab.
 
               Minimum length: 1
             </ResponseField>
             <IconsOptional />
             <ResponseField name="hidden" type="boolean">
-              Whether to hide this dropdown by default.
+              Whether to hide this tab by default.
             </ResponseField>
             <ResponseField name="href" type="string (uri)" required>
-              URL or path for the dropdown destination.
+              URL or path for the tab destination.
             </ResponseField>
           </Expandable>
         </ResponseField>
@@ -430,8 +430,8 @@
 
     </ResponseField>
 
-    <ResponseField name="dropdowns" type="array of object">
-      [Dropdowns](navigation#dropdowns) for grouping related content.
+    <ResponseField name="tabs" type="array of object">
+      [Tabs](navigation#tabs) for organizing content into distinct sections.
 
     </ResponseField>
     <ResponseField name="groups" type="array of object">
@@ -923,11 +923,10 @@
         "dark": "#0F172A"
       },
       "navigation": {
-        "dropdowns": [
+        "tabs": [
           {
-            "dropdown": "Documentation",
+            "tab": "Documentation",
             "icon": "book",
-            "description": "How to use the Example Co. product",
             "groups": [
               {
                 "group": "Getting started",
@@ -955,9 +954,8 @@
             ]
           },
           {
-            "dropdown": "Changelog",
+            "tab": "Changelog",
             "icon": "history",
-            "description": "Updates and changes",
             "pages": [
               "changelog"
             ]
@@ -1072,11 +1070,10 @@
         "dark": "#0F172A"
       },
       "navigation": {
-        "dropdowns": [
+        "tabs": [
           {
-            "dropdown": "Documentation",
+            "tab": "Documentation",
             "icon": "book",
-            "description": "How to use the Example Co. product",
             "groups": [
               {
                 "group": "Getting started",
@@ -1104,9 +1101,8 @@
             ]
           },
           {
-            "dropdown": "API reference",
+            "tab": "API reference",
             "icon": "terminal",
-            "description": "How to use the Example Co. API",
             "groups": [
               {
                 "group": "API reference",
@@ -1123,9 +1119,8 @@
             ]
           },
           {
-            "dropdown": "Changelog",
+            "tab": "Changelog",
             "icon": "history",
-            "description": "Updates and changes",
             "pages": [
               "changelog"
             ]
@@ -1263,12 +1258,11 @@
         "languages": [ // [!code highlight:3]
           {
             "language": "en",
-            "dropdowns": [
+            "tabs": [
               {
-                "dropdown": "Documentation",
+                "tab": "Documentation",
                 "icon": "book",
-                "description": "How to use the Example Co. product",
-                "pages": [
+                "groups": [
                   {
                     "group": "Getting started",
                     "pages": ["index", "quickstart"]
@@ -1288,21 +1282,19 @@
                 ]
               },
               {
-                "dropdown": "Changelog",
+                "tab": "Changelog",
                 "icon": "history",
-                "description": "Updates and changes",
                 "pages": ["changelog"]
               }
             ]
           },
           {
             "language": "es",// [!code highlight]
-            "dropdowns": [
+            "tabs": [
               {
-                "dropdown": "Documentación",
+                "tab": "Documentación",
                 "icon": "book",
-                "description": "Cómo usar el producto de Example Co.",
-                "pages": [
+                "groups": [
                   {
                     "group": "Comenzando",
                     "pages": ["es/index", "es/quickstart"]
@@ -1322,9 +1314,8 @@
                 ]
               },
               {
-                "dropdown": "Changelog",
+                "tab": "Changelog",
                 "icon": "history",
-                "description": "Actualizaciones y cambios",
                 "pages": ["es/changelog"]
               }
             ]