mintlify · skeptrunedev · Aug 9, 2025 · Aug 9, 2025
diff --git a/changelog.mdx b/changelog.mdx
@@ -5,6 +5,47 @@
 noindex: true
 ---
 
+<Update label="August 3 - August 9" 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 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 so you can build agents and MCP servers on top of your docs
+  - `openapi` and `asyncapi` files are now served at their specified paths (e.g. `https://mydocsurl.extension/{openapi-or-file-name}.json`)
+  - You can now use the `x-mint` field in your openapi files to override generated fields, customize preface content, or change endpoint URLs in code samples
+  - `x-mcp` is now `x-mint.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 from last week
+
+  ## Performance and reliability
+
+  - All image and video assets in your repo are now served at the expected path on your domain (e.g. `/assets/marketing/my-logo.png`)
+  - Email field on login for the Mintlify dashboard now autofocuses so you can start typing immediately
+  - 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 our error logging output for greater readability and faster triage
+  - 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="July 27 - August 2" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Authentication improvements, search enhancements, and assistant API" }}>
   ## Authentication improvements
 
@@ -27,7 +68,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
@@ -35,7 +76,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>
@@ -43,7 +84,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
@@ -62,17 +103,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

@@ -159,7 +200,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"]}>
@@ -190,9 +231,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

@@ -274,7 +315,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

@@ -346,7 +387,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.
@@ -360,7 +401,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.
@@ -393,7 +434,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

@@ -427,7 +468,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.

@@ -460,7 +501,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)
@@ -495,7 +536,7 @@
 <Update label="May 2024">
  ## Okta SSO

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

  ## Mintlify REST API

@@ -518,7 +559,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">
@@ -527,7 +568,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">
@@ -537,4 +578,4 @@
   - 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>
+</Update>