mintlify · mintlify · Aug 28, 2026 · Aug 28, 2026
diff --git a/changelog.mdx b/changelog.mdx
@@ -5,11 +5,49 @@
 noindex: true
 ---
 
+<Update label="August 28, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Referral program, MDX component, private page search, and more" }}>
+
+  ## New features
+
+  - **Referral program:** Refer a team to Mintlify from the **Referrals** page in dashboard settings. When a referred team signs up for Pro, both organizations receive $500 in agent credits. Available on Pro and Growth plans.
+  - **`<MDX>` component:** Wrap content in `<MDX>` to render Markdown formatting inside JSX expressions, such as conditional content.
+  - **`className` on components:** Built-in components now accept a `className` prop, so you can apply custom styles to accordions, callouts, steps, tabs, code blocks, and more.
+  - **Private page search:** Editor search now includes your private pages, and you can open results directly from the search palette. See [Private pages](/editor/pages#private-pages).
+  - **Agent replies to mentions:** Mention `@mintlify` in a comment, suggestion, or reply and the editor agent answers in the same thread, including on private pages. See [Ask the Mintlify agent](/editor/collaborate#ask-the-mintlify-agent).
+
+  ## Improvements
+
+  - **Redesigned automation runs:** The runs tab shows a grouped feed of each run's results, including pull requests, modified pages, and failures, with status filters and a review-needed indicator. Automation configuration moved from a flyout to a dedicated configure page. See [Manage automations](/automations/manage).
+  - **`mint analytics`:** View traffic stats, search queries, feedback, and assistant conversations from the CLI. See [`mint analytics`](/cli/commands#mint-analytics).
+  - **Clickable agent questions:** When the editor agent asks a clarifying question, click an option to answer instead of typing.
+  - **SVG attachments:** Attach SVG files to editor agent messages. See [Attach files](/editor/agent#attach-files).
+  - **Faster branching:** Creating a branch in the editor switches you to it instantly, the editor guides you through branch protection rules, and pull request status updates arrive through webhooks instead of polling.
+  - **Math editing:** Math expressions in the editor now update their rendered preview live as you type.
+  - **Component properties panel:** The editor's component properties panel has a refreshed design and autosaves your changes.
+  - **Discoverable `llms.txt` indexes:** The root `llms.txt` now links to the per-section indexes under `/_llms`, and optional links are indexed by navigation scope. See [llms.txt](/ai/llmstxt).
+  - **Universal Search MCP rate limit:** The rate limit is raised to 5,000 requests per day.
+  - **Organization switching:** Opening an editor link that belongs to another of your organizations now prompts you to switch instead of showing an error.
+
+  ## Bug fixes
+
+  - **Safari media:** Images and videos uploaded to your docs now load correctly in Safari.
+  - **Accordions:** HTML tables inside accordions render instead of being dropped.
+  - **Code groups:** Expandable code blocks inside a `CodeGroup` no longer grow past their collapsed height.
+  - **iOS zoom:** Focusing search and assistant inputs on iOS no longer zooms the page.
+  - **Favicons:** Favicon URLs resolve correctly on deployments with a custom base path.
+  - **API playground:** Enum array items render their values instead of type labels.
+  - **`llms.txt` languages:** Language-specific `llms.txt` routes are scoped to their language, the default language is prioritized, and `llms-full.txt` headings and links are normalized.
+  - **`mint format`:** CLI formatting now matches the editor's output, so formatting a file no longer produces spurious diffs.
+  - **Editor fixes:** Removing a page icon persists, focus returns to the page after toolbar dropdown picks, and deleting the page you have open redirects instead of showing a stale view.
+  - **Assistant widget:** The widget refreshes its configuration before it expires, so long-lived pages keep a working assistant.
+
+</Update>
+
 <Update label="August 21, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Editor branches, Slack-triggered automations, bulk member invites, and more" }}>
 
   ## Editor and collaboration

  - **Editor branches:** When you create a branch, the editor now creates a draft pull request and autosaves changes to Git. You can rename or delete branches, discard autosaved changes, and move pending changes to a new branch. The branch menu is ordered by recent activity, uses per-user branch names, and shows cleaner `Draft <date>` names for automatically generated branches. See [Branching and publishing](/editor/publish).
  - **Pull requests open as drafts by default:** The editor now opens new pull requests in draft state so you can share a preview URL without signaling that the change is ready to merge. Change this on the [editor settings](/editor/settings) page.
  - **GitLab merge requests:** Merge requests opened in GitLab now sync into editor branches, matching the existing GitHub behavior.
  - **Streamlined editor navigation:** The editor has a new breadcrumbs row, consolidated page and share controls, sticky sidebar section headers, and a dedicated bottom bar for settings and **Ask agent**. Site settings open as editor pages instead of a modal. Mobile navigation now uses a simplified top bar and panel-based sidebar for smaller screens.
@@ -24,12 +62,12 @@

  ## Docs and delivery

  - **Custom SDK reference pages:** Use `sdk` frontmatter to generate documentation for a single SDK symbol while adding your own examples or guidance above it. You can also configure SDK generation for a navigation group. See [Customize a page for a single symbol](/api-playground/sdk-reference-setup#customize-a-page-for-a-single-symbol).
  - **GraphQL input types:** Input type pages are now generated and served on GraphQL API reference sites. See [GraphQL setup](/api-playground/graphql-setup).
  - **`nocopy` code blocks:** Add the `nocopy` flag to a fenced code block to hide its copy button. For plain-text content such as ASCII diagrams, use a bare `nocopy` fence. See [Hide copy button](/create/code#hide-copy-button).
  - **Result snippets:** Optionally show a one-line content preview beneath each search result, with matching terms highlighted. Enable **Result snippets** from your dashboard search settings; the setting is off by default. See [Result snippets](/optimize/search#result-snippets).
  - **Scoped `llms.txt` indexes:** Grouped `llms.txt` indexes are now served per URL segment at `/_llms/<segment>.md`, so agents can pull one section of your docs instead of the full index.
  - **Assistant widget analytics:** Analytics events now include the embedding page's current pathname by default and follow client-side navigation. Set `analytics.capturePathname` to `false` to opt out. See [assistant analytics config](/assistant/widget#assistantanalyticsconfig).
  - **Bulk member invites:** Invite up to 250 teammates at once, then review the list and assign a role to each invitee before sending. Pro and Enterprise plans can upload a CSV of email addresses. See [Add members to your organization](/dashboard/roles#add-members-to-your-organization).
  - **Universal Search API keys:** Universal Search API keys are out of early access. Any organization can now create and manage them from dashboard settings.
  - **Analytics in self-hosted deployments:** The dashboard analytics tab is now available on self-hosted deployments.
@@ -39,7 +77,7 @@
  - **API playground:** OpenAPI 3.1 examples and enum values now appear in generated response samples, and Markdown lists in the endpoint modal no longer render double bullets.
  - **Search anchors:** JSX headings with custom IDs now create the correct search sections and anchors.
  - **Inline styles:** Inline CSS in a quoted `style` attribute now renders correctly on your site, in the CLI, and in the editor.
  - **Editor components:** Copying and pasting inside a `Step` no longer creates nested steps, tabs no longer jump when clicked, and settings sidebar search has been restored.
  - **Editor deep links:** Opening an editor link while signed out now returns you to that page after login instead of the dashboard home page.
  - **Anchor icons:** Anchor link icons remain white when hovering over a dark background.
  - **Assistant widget loading:** The widget stays interactive while it's loading.
@@ -47,7 +85,7 @@

 </Update>

 <Update label="August 14, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Bitbucket Cloud support, embed a GitHub repo in your docs, and more" }}>

  ## Bitbucket Cloud support

@@ -60,18 +98,18 @@
  - **Editor branch creation:** Branch creation is faster and you can bring or stash pending changes when branching. You can also edit a branch's pull request title from the editor.
  - **Private pages:** Private pages have their own version history, agent annotations, and notification emails. Move a private page to a workspace folder to publish it to your site.
  - **Personal and shared sections:** The editor sidebar has **Personal** and **Shared** sections so private drafts and shared content are easier to separate.
  - **Editor comments:** Long comment bodies clamp to six lines with a **Show more** control, and the comment card scrolls, keyboard shortcuts, and edit input have been polished.
  - **Batch member invites:** Invite multiple teammates to your organization at once from the dashboard.
  - **Collaborators in branches:** The branches dropdown shows collaborators on each branch, avatars dedupe across Git and editor identities, and pull request authors are included in the contributors list. External pushes to editor branches sync into the editor in real time.

  ## Docs and delivery

  - **GitHub component:** Embed a public GitHub repository card with a live description, star count, and fork count on any page. See [GitHub](/components/github) for usage and variants.
  - **Language-preference routing:** Redirect visitors from the root of your site to the language that matches their browser's `Accept-Language` header. Enable **Auto-route to preferred language** on the [Add-ons](https://app.mintlify.com/settings/deployment/addons) page. See [Navigation](/organize/navigation#route-visitors-to-their-preferred-language) for details.
  - **`lastUpdatedDate` frontmatter:** The last-modified footer now prefers a `lastUpdatedDate` value in a page's frontmatter over the Git commit date.
  - **Search relevance:** Verbatim identifier matches are promoted in search results, and identifier tokens are preserved across chunk splits.
  - **Translation reliability:** Full-site translation triggers are fixed, and the translation timeout is raised to accommodate larger sites.
  - **API playground endpoint menu:** Refined layout and spacing, correct column sizing for OPTIONS, and typing in the endpoint search is fixed.

  ## Agent integrations

@@ -84,15 +122,15 @@
  - **Assistant history:** Clarifying questions from the assistant now render in dashboard conversation history and in analytics exports.
  - **Reject editor suggestions:** The reject button for suggestions now appears inline.
  - **Multi-repo variables:** Variables now resolve correctly in multi-repo deployment configurations.
  - **GitLab webhooks:** Push events from the GitLab OAuth webhook endpoint are handled correctly.
  - **Broken-links CLI:** `mint broken-links` now resolves paths with non-ASCII characters.
  - **Snippet validation:** `mint validate` warns when a snippet uses a default import against a file that has no default export.
  - **Markdown task lists:** Task list items in Markdown are styled correctly.
  - **Focus outlines:** Interactive focus outlines are aligned consistently across the site.
  - **Dropdown switcher:** Switching between dropdowns now routes to the matching page in the target dropdown instead of the dropdown root.
  - **Anchors with base paths:** Author-written anchors resolve correctly on deployments that use a custom base path.
  - **Editor nav bar:** Long titles in the editor top bar truncate cleanly instead of overflowing.
  - **GitHub settings visibility:** GitHub app settings are hidden on deployments connected to other Git providers.
  - **PDF attachments:** Uploaded PDF attachments no longer render inside a live embed.

 </Update>
@@ -104,7 +142,7 @@
  - **Mintlify Index:** [Mintlify Index](/search-index) gives coding agents one retrieval layer for publisher-maintained technical documentation and the broader web.
  - **`mint index setup`:** Connect to the [Mintlify Index](/search-index) from the CLI.
  - **Pylon, LaunchDarkly, and PostHog integration:** Connect [Pylon, LaunchDarkly, and PostHog](/automations/integrations) as read-only integrations so the agent can use context from those tools in Slack and automations.
  - **Private pages:** Private pages are now available in the editor. Create pages only you can see, nest them in folders, and promote them to your workspace when they're ready to be published.
  - **User journey analytics (beta):** [Analytics](/analytics) shows the routes visitors take through your site, actions they take, and their search and chat behavior.

  ## Improvements
@@ -132,8 +170,8 @@
  - **Sidebar items:** Plain sidebar items now render at full width.
  - **Preview handshakes:** Preview auth handshakes redirect back to the exact host you started from, including the mount path, so deep links resolve correctly.
  - **Integration logos:** OneDrive now shows its real logo.
  - **MDX comments:** Inline MDX comments are stripped from the `.md` route served to agents.
  - **Static export links:** Compile-time `.html` link mode now resolves versioned and trailing-slash slugs correctly.

 </Update>

@@ -168,8 +206,8 @@
  - **Editor-first dashboard:** The editor is now the homepage of the Mintlify dashboard. Other pages, like activity, analytics, products, and settings, now open in a modal on top of it, and every page keeps its own URL.
  - **Redesigned editor:** New navigation tree, top bar, and page design. Create files in **Home** and structure your navigation in **Publishing**.
  - **Organization-level credits:** Credits are now shared at the organization level instead of per deployment, so every deployment on a plan draws from one shared balance. See [Credit pricing](/credits) for more information.
  - **Editor performance:** Navigation validation, page lookups, and tab switches in the editor are now linear instead of quadratic, so large sites open and edit faster.
  - **Personalization moved to add-ons:** [Personalization](/create/personalization) settings are now available under add-ons in the dashboard and can be configured on deployments that use a custom base path.
  - **Truncated pagination titles:** Long titles in next/previous footer links truncate so they no longer overflow.
  - **Long filename handling:** Uploaded files with names over 255 characters now truncate.

@@ -193,7 +231,7 @@

  ## GraphQL and SDK references

  - **GraphQL API reference pages:** Generate reference pages from a GraphQL SDL schema, with linked types and example queries, mutations, and responses. See [GraphQL setup](/api-playground/graphql-setup).
  - **SDK reference generation:** Build SDK reference pages directly from the output of TypeDoc, DocFX, Javadoc, Sphinx, or phpDocumentor. See [SDK reference setup](/api-playground/sdk-reference-setup).

  ## Editor and collaboration
@@ -255,8 +293,8 @@

  - **Faster deployment queues:** Preview deployments can now run more builds concurrently to reduce queue times.
  - **Resend member invitations:** Resend outstanding invitations to new organization members from the dashboard.
  - **Better signup feedback:** Signup now reports subdomain availability and suggests an available subdomain when your first choice is taken.
  - **Skipped deployment statuses:** The dashboard now shows when a deployment update was skipped instead of leaving its status unclear.
  - **Trailing-slash SEO config:** New `seo.trailingSlash` option in [`docs.json`](/organize/settings-seo) enforces consistent trailing-slash URLs across your site.

  ## Automations and Slack agent
@@ -281,9 +319,9 @@
  - Reduced assistant errors while a response is streaming.
  - Assistant chat history now preserves response text when a response ends with a tool call.
  - Mermaid diagram actions now show on hover as expected.
  - Version switcher is scoped to the versions available in the current dropdown.
  - Navigation-level `public: false` settings are now respected in authentication metadata.
  - Long chat-history messages are truncated instead of horizontally scrolling.
  - Static assets and favicons now send `X-Robots-Tag: noindex` to keep them out of search results.
  - `BreadcrumbList` JSON-LD no longer emits empty list items.

@@ -353,14 +391,14 @@
  ## Assistant skills and support handoff

  - **Assistant skills:** Add [skills](/assistant/skills) that the assistant loads on demand via a `loadSkill` tool call, so it can answer with your team's hand-written, opinionated guidance instead of relying on search results alone.
  - **Assistant contact form:** The [assistant](/assistant) can now present an in-chat contact form to hand off to support or sales when a question can't be answered from your content.
  - **Themed query categories in assistant analytics:** [Assistant analytics](/analytics) groups related questions into categories and shows thumbs-up/thumbs-down sentiment per category, so you can review frequent topics your users are asking about.
  - **Hosted MCP submit feedback tool:** Agents connected to your [hosted search MCP server](/ai/model-context-protocol#mcp-tools) can now report issues back to your team, recorded as unhelpful feedback in your analytics dashboard.

  ## Enterprise security

  - **Session IP allowlist:** Restrict dashboard sessions to allowed IP ranges as part of your [SSO and session security policy](/dashboard/sso).
  - **SCIM user provisioning and deprovisioning:** Provision and deprovision users through SCIM, with automatic session revocation, machine-credential revocation, and audit-log events when a user is deactivated.

  ## Improvements

@@ -368,10 +406,10 @@
  - **Hosted MCP admin connect page:** New admin connect page and hosted MCP auth settings in the dashboard under Settings.
  - **`searchable` frontmatter field:** Set `searchable: false` on a [page](/organize/pages) to omit it from site search results.
  - **`.md` routes for section pages:** Section landing and collection index pages now resolve at their `.md` route for AI/LLM tooling.
  - **`@mintlify` PR bot on fork branches:** The `@mintlify` GitHub bot now pushes comment edits directly to fork branches when the Mintlify app is installed on the fork, and supports PRs opened against docs repos.
  - **Publish concurrency safety in the editor:** The [editor](/editor) broadcasts when a publish starts so other clients block immediately, and the publish dropdown can be dismissed during loading. Publish failures now include a summary.
  - **Resumable editor agent streams:** The [editor agent](/editor) reconnects to in-flight streams after a disconnect instead of restarting from scratch.
  - **Slack agent resilience:** The [Slack agent](/agent/slack) recovers cleanly when a message is interrupted and no longer leaves loaders spinning; switch-deployment flows are hardened.
  - **SSO copy refresh:** The [SSO](/dashboard/sso) settings page has clearer sections and updated GitLab configuration instructions.
  - **Usage activity CSV export:** [Export your usage activity log](/credits#export-usage-activity) to CSV from the Usage page for deeper analysis, reporting, or record-keeping.

@@ -384,45 +422,45 @@
  - Editing a doc file's title in the editor no longer resets it to the default.
  - Assistant category occurrence counts now respect the selected date range.
  - Removed invalid `charset`, `canonical`, and `og:*` meta tags from rendered pages.
  - Automation run rows on the [automations page](/automations) are clickable to their details page, and the weekly run comparison indicator was removed.
  - Editor `docs.json` over 1 MB now falls back to the blob API so large configs load reliably.
  - Force-pushes to a connected Git branch are now handled gracefully during editor sync.
  - Self-hosted deployments correctly use the client URL as the preview base, and the self-host Lambda starts the self-hosted client.

 </Update>

 <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.
@@ -433,19 +471,19 @@

  ## 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.
@@ -455,11 +493,11 @@

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

@@ -471,9 +509,9 @@

  ## 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.
@@ -482,10 +520,10 @@

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

@@ -494,7 +532,7 @@
  - 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.
@@ -520,7 +558,7 @@

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

@@ -548,7 +586,7 @@
  - **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.

@@ -562,7 +600,7 @@
  ## 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 updated for clarity.

  ## API playground
@@ -594,11 +632,11 @@
  ## 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.
@@ -606,12 +644,12 @@
 </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.
@@ -619,7 +657,7 @@
  ## 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
@@ -636,19 +674,19 @@
  - **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.

@@ -667,13 +705,13 @@
 <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

@@ -703,7 +741,7 @@

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

@@ -731,7 +769,7 @@

  ## 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.
@@ -742,7 +780,7 @@

  ## 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).
@@ -754,20 +792,20 @@
  - 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.
@@ -781,7 +819,7 @@
  ## 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

@@ -822,17 +860,17 @@
  - 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.
@@ -862,11 +900,11 @@

  ## 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
@@ -878,19 +916,19 @@
  - 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.
@@ -901,7 +939,7 @@
  - 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.
@@ -918,8 +956,8 @@

  - 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/review#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.
@@ -969,7 +1007,7 @@

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

@@ -994,7 +1032,7 @@
  - 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>

@@ -1100,9 +1138,9 @@

  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

@@ -1169,7 +1207,7 @@

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

@@ -1198,7 +1236,7 @@

  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.

@@ -1290,7 +1328,7 @@
 </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.

@@ -1300,17 +1338,17 @@

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

@@ -1321,7 +1359,7 @@

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

@@ -1382,7 +1420,7 @@
  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

@@ -1416,7 +1454,7 @@
  - Updated [publishing workflow](/editor/publish) 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.
@@ -1434,8 +1472,8 @@
 <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.
@@ -1450,7 +1488,7 @@

  - **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
@@ -1459,11 +1497,11 @@
  - 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>

@@ -1483,7 +1521,7 @@

  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" }}>
@@ -1497,8 +1535,8 @@

  ## 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
@@ -1506,7 +1544,7 @@
  - 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" }}>
@@ -1520,7 +1558,7 @@
 <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.

@@ -1539,7 +1577,7 @@
  - 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.
@@ -1550,7 +1588,7 @@

  ## 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" }}>
@@ -1568,14 +1606,14 @@
  - 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
@@ -1590,7 +1628,7 @@

  ## 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
@@ -1616,14 +1654,14 @@
 <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.
@@ -1631,7 +1669,7 @@
  ## 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

@@ -1654,7 +1692,7 @@
  ## 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
@@ -1769,13 +1807,13 @@
  ## 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
@@ -1792,7 +1830,7 @@
  - **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

@@ -1831,7 +1869,7 @@

  - 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

@@ -1867,7 +1905,7 @@
  - 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" }}>
@@ -1890,7 +1928,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
@@ -1901,7 +1939,7 @@
  ## 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
@@ -1932,16 +1970,16 @@
  - 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" }}>
@@ -1953,13 +1991,13 @@
  ## 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
@@ -1971,7 +2009,7 @@

  - 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" }}>
@@ -1989,7 +2027,7 @@
  - 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

@@ -2033,8 +2071,8 @@
  ## 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

@@ -2054,7 +2092,7 @@

  - 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`
@@ -2064,8 +2102,8 @@
  - 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>
@@ -2080,7 +2118,7 @@

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

@@ -2095,7 +2133,7 @@

  - 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
@@ -2161,11 +2199,11 @@
  Can now use `mint update` to update your CLI.
 </Update>

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

  <Frame>
    ![Webeditor3 Jpe](/images/webeditor3.jpeg)
  </Frame>

  Overhauled usability in the WYSIWYG editor.
@@ -2182,13 +2220,13 @@

  - 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>
@@ -2210,7 +2248,7 @@
  ## MCP server generator

  <Frame>
    ![screenshot of MCP server generator](/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)
@@ -2227,7 +2265,7 @@
  - 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>

@@ -2255,7 +2293,7 @@
  ```

  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).
@@ -2263,7 +2301,7 @@
  ## .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>
@@ -2282,10 +2320,10 @@

  - [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
@@ -2296,7 +2334,7 @@
  ## 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:
@@ -2320,26 +2358,26 @@
  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>
    ![AI Assistant](/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>
    ![Web Editor](/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).

@@ -2353,7 +2391,7 @@

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

@@ -2369,7 +2407,7 @@
  <Frame>
    ![Changelog](/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.
@@ -2401,7 +2439,7 @@
    "mode": "auto"
  }
  ```

  ## Advanced Footer

  <Frame>
@@ -2412,8 +2450,8 @@

  ## 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.
@@ -2425,15 +2463,15 @@
  - 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
@@ -2442,7 +2480,7 @@
  - Maintain scroll position when you click the back button in a browser.
 </Update>

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

  <Frame>
@@ -2450,11 +2488,11 @@
  </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>
@@ -2475,11 +2513,11 @@

  - 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-ons 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`.
@@ -2487,15 +2525,15 @@

  ## 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.
@@ -2505,19 +2543,19 @@
  ## 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>
@@ -2527,7 +2565,7 @@
  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.
@@ -2537,7 +2575,7 @@
  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.
@@ -2550,8 +2588,8 @@
 <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.
@@ -2584,11 +2622,11 @@
  - 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>
diff --git a/es/changelog.mdx b/es/changelog.mdx
@@ -5,6 +5,50 @@ rss: true
 noindex: true
 ---
 
+<Update label="28 de agosto de 2026" tags={["Nuevos lanzamientos","Mejoras","Correcciones"]} rss={{ title:"Programa de referidos, componente MDX, búsqueda de páginas privadas y más" }}>
+
+<div id="new-features">
+  ## Nuevas funcionalidades
+</div>
+
+  - **Programa de referidos:** Recomienda un equipo a Mintlify desde la página **Referrals** en la configuración del dashboard. Cuando un equipo referido se suscribe a Pro, ambas organizaciones reciben $500 en créditos de agente. Disponible en los planes Pro y Growth.
+  - **Componente `<MDX>`:** Envuelve contenido en `<MDX>` para renderizar formato Markdown dentro de expresiones JSX, como contenido condicional.
+  - **`className` en componentes:** Los componentes integrados ahora aceptan una prop `className`, para que puedas aplicar estilos personalizados a accordions, callouts, steps, tabs, bloques de código y más.
+  - **Búsqueda de páginas privadas:** La búsqueda del editor ahora incluye tus páginas privadas, y puedes abrir los resultados directamente desde la paleta de búsqueda. Consulta [Páginas privadas](/es/editor/pages#private-pages).
+  - **El agente responde a las menciones:** Menciona `@mintlify` en un comentario, sugerencia o respuesta y el agente del editor responde en el mismo hilo, incluso en páginas privadas. Consulta [Preguntar al agente de Mintlify](/es/editor/collaborate#ask-the-mintlify-agent).
+
+<div id="improvements">
+  ## Mejoras
+</div>
+
+  - **Ejecuciones de automatizaciones rediseñadas:** La pestaña de ejecuciones muestra un feed agrupado con los resultados de cada ejecución, incluidos pull requests, páginas modificadas y fallos, con filtros de estado y un indicador de revisión pendiente. La configuración de las automatizaciones pasó de un panel flotante a una página de configuración dedicada. Consulta [Gestionar automatizaciones](/es/automations/manage).
+  - **`mint analytics`:** Consulta estadísticas de tráfico, búsquedas, feedback y conversaciones del assistant desde la CLI. Consulta [`mint analytics`](/es/cli/commands#mint-analytics).
+  - **Preguntas del agente con clic:** Cuando el agente del editor hace una pregunta aclaratoria, haz clic en una opción para responder en lugar de escribir.
+  - **Adjuntos SVG:** Adjunta archivos SVG a los mensajes del agente del editor. Consulta [Adjuntar archivos](/es/editor/agent#attach-files).
+  - **Ramas más rápidas:** Crear una rama en el editor te cambia a ella al instante, el editor te guía a través de las reglas de protección de ramas y las actualizaciones de estado de los pull requests llegan mediante webhooks en lugar de sondeo.
+  - **Edición de fórmulas matemáticas:** Las expresiones matemáticas en el editor ahora actualizan su vista previa renderizada en vivo mientras escribes.
+  - **Panel de propiedades de componentes:** El panel de propiedades de componentes del editor tiene un diseño renovado y guarda tus cambios automáticamente.
+  - **Índices `llms.txt` descubribles:** El `llms.txt` raíz ahora enlaza a los índices por sección bajo `/_llms`, y los enlaces opcionales se indexan por ámbito de navegación. Consulta [llms.txt](/es/ai/llmstxt).
+  - **Límite de peticiones del MCP de Universal Search:** El límite sube a 5,000 peticiones por día.
+  - **Cambio de organización:** Abrir un enlace del editor que pertenece a otra de tus organizaciones ahora te propone cambiar en lugar de mostrar un error.
+
+<div id="bug-fixes">
+  ## Correcciones de errores
+</div>
+
+  - **Contenido multimedia en Safari:** Las imágenes y los vídeos subidos a tu documentación ahora se cargan correctamente en Safari.
+  - **Accordions:** Las tablas HTML dentro de accordions se renderizan en lugar de descartarse.
+  - **Grupos de código:** Los bloques de código expandibles dentro de un `CodeGroup` ya no crecen más allá de su altura contraída.
+  - **Zoom en iOS:** Enfocar los campos de búsqueda y del assistant en iOS ya no hace zoom en la página.
+  - **Favicons:** Las URL de favicon se resuelven correctamente en deployments con una ruta base personalizada.
+  - **Playground de API:** Los elementos de arrays de enums renderizan sus valores en lugar de etiquetas de tipo.
+  - **Idiomas de `llms.txt`:** Las rutas `llms.txt` específicas de cada idioma se limitan a su idioma, se prioriza el idioma predeterminado y se normalizan los encabezados y enlaces de `llms-full.txt`.
+  - **`mint format`:** El formateo de la CLI ahora coincide con la salida del editor, por lo que formatear un archivo ya no produce diffs espurios.
+  - **Correcciones del editor:** Eliminar el icono de una página se guarda de forma persistente, el foco vuelve a la página después de elegir en un menú desplegable de la barra de herramientas y eliminar la página que tienes abierta redirige en lugar de mostrar una vista obsoleta.
+  - **Widget del assistant:** El widget actualiza su configuración antes de que caduque, por lo que las páginas abiertas durante mucho tiempo mantienen un assistant funcional.
+
+</Update>
+
 <Update label="21 de agosto de 2026" tags={["Nuevos lanzamientos","Mejoras","Correcciones"]} rss={{ title:"Branches v2, automatizaciones activadas por Slack y referencias de SDK personalizables" }}>
 
 <div id="editor-and-collaboration">

diff --git a/fr/changelog.mdx b/fr/changelog.mdx
@@ -5,6 +5,50 @@ rss: true
 noindex: true
 ---
 
+<Update label="28 août 2026" tags={["Nouvelles versions", "Améliorations", "Corrections de bugs"]} rss={{ title: "Programme de parrainage, composant MDX, recherche de pages privées et plus" }}>
+
+<div id="new-features">
+  ## Nouvelles fonctionnalités
+</div>
+
+  - **Programme de parrainage :** Recommandez une équipe à Mintlify depuis la page **Referrals** des paramètres du dashboard. Lorsqu'une équipe parrainée s'abonne à Pro, les deux organisations reçoivent 500 $ de crédits d'agent. Disponible sur les plans Pro et Growth.
+  - **Composant `<MDX>` :** Entourez du contenu avec `<MDX>` pour afficher la mise en forme Markdown dans des expressions JSX, comme du contenu conditionnel.
+  - **`className` sur les composants :** Les composants intégrés acceptent désormais une prop `className`, pour appliquer des styles personnalisés aux accordions, callouts, steps, tabs, blocs de code et plus encore.
+  - **Recherche de pages privées :** La recherche de l'éditeur inclut désormais vos pages privées, et vous pouvez ouvrir les résultats directement depuis la palette de recherche. Consultez [Pages privées](/fr/editor/pages#private-pages).
+  - **L'agent répond aux mentions :** Mentionnez `@mintlify` dans un commentaire, une suggestion ou une réponse et l'agent de l'éditeur répond dans le même fil, y compris sur les pages privées. Consultez [Interroger l'agent Mintlify](/fr/editor/collaborate#ask-the-mintlify-agent).
+
+<div id="improvements">
+  ## Améliorations
+</div>
+
+  - **Exécutions d'automatisations repensées :** L'onglet des exécutions affiche un flux groupé des résultats de chaque exécution, y compris les pull requests, les pages modifiées et les échecs, avec des filtres de statut et un indicateur de revue à faire. La configuration des automatisations passe d'un panneau volant à une page de configuration dédiée. Consultez [Gérer les automatisations](/fr/automations/manage).
+  - **`mint analytics` :** Consultez les statistiques de trafic, les recherches, le feedback et les conversations de l'assistant depuis la CLI. Consultez [`mint analytics`](/fr/cli/commands#mint-analytics).
+  - **Questions de l'agent cliquables :** Lorsque l'agent de l'éditeur pose une question de clarification, cliquez sur une option pour répondre au lieu de taper.
+  - **Pièces jointes SVG :** Joignez des fichiers SVG aux messages de l'agent de l'éditeur. Consultez [Joindre des fichiers](/fr/editor/agent#attach-files).
+  - **Branches plus rapides :** Créer une branche dans l'éditeur vous y bascule instantanément, l'éditeur vous guide à travers les règles de protection de branches et les mises à jour de statut des pull requests arrivent par webhooks plutôt que par sondage.
+  - **Édition mathématique :** Les expressions mathématiques dans l'éditeur mettent désormais à jour leur aperçu rendu en direct pendant que vous tapez.
+  - **Panneau des propriétés de composants :** Le panneau des propriétés de composants de l'éditeur a un design rafraîchi et enregistre automatiquement vos modifications.
+  - **Index `llms.txt` découvrables :** Le `llms.txt` racine renvoie désormais vers les index par section sous `/_llms`, et les liens optionnels sont indexés par portée de navigation. Consultez [llms.txt](/fr/ai/llmstxt).
+  - **Limite de requêtes du MCP Universal Search :** La limite passe à 5 000 requêtes par jour.
+  - **Changement d'organisation :** Ouvrir un lien de l'éditeur appartenant à une autre de vos organisations vous propose désormais de changer d'organisation au lieu d'afficher une erreur.
+
+<div id="bug-fixes">
+  ## Corrections de bugs
+</div>
+
+  - **Médias sur Safari :** Les images et vidéos téléversées dans votre documentation se chargent désormais correctement dans Safari.
+  - **Accordions :** Les tableaux HTML à l'intérieur des accordions s'affichent au lieu d'être supprimés.
+  - **Groupes de code :** Les blocs de code dépliables dans un `CodeGroup` ne grandissent plus au-delà de leur hauteur repliée.
+  - **Zoom iOS :** Sélectionner les champs de recherche et de l'assistant sur iOS ne zoome plus la page.
+  - **Favicons :** Les URL de favicon se résolvent correctement sur les déploiements avec un chemin de base personnalisé.
+  - **Playground d'API :** Les éléments de tableaux d'enums affichent leurs valeurs au lieu d'étiquettes de type.
+  - **Langues de `llms.txt` :** Les routes `llms.txt` spécifiques à une langue sont limitées à leur langue, la langue par défaut est priorisée et les titres et liens de `llms-full.txt` sont normalisés.
+  - **`mint format` :** Le formatage de la CLI correspond désormais à la sortie de l'éditeur, donc formater un fichier ne produit plus de diffs parasites.
+  - **Corrections de l'éditeur :** La suppression de l'icône d'une page est conservée, le focus revient à la page après un choix dans un menu déroulant de la barre d'outils et supprimer la page ouverte redirige au lieu d'afficher une vue obsolète.
+  - **Widget de l'assistant :** Le widget rafraîchit sa configuration avant expiration, donc les pages ouvertes longtemps conservent un assistant fonctionnel.
+
+</Update>
+
 <Update label="21 août 2026" tags={["Nouvelles versions", "Améliorations", "Corrections de bugs"]} rss={{ title: "Branches v2, automatisations déclenchées par Slack et références SDK personnalisables" }}>
 
 <div id="editor-and-collaboration">

diff --git a/zh/changelog.mdx b/zh/changelog.mdx
@@ -5,6 +5,50 @@ rss: true
 noindex: true
 ---
 
+<Update label="2026年8月28日" tags={["新版本","改进","错误修复"]} rss={{ title:"推荐计划、MDX 组件、私有页面搜索等" }}>
+
+<div id="new-features">
+  ## 新功能
+</div>
+
+  - **推荐计划：** 在 dashboard 设置的 **Referrals** 页面向 Mintlify 推荐一个团队。当被推荐的团队订阅 Pro 时，双方组织都会获得 $500 的 agent 额度。适用于 Pro 和 Growth 计划。
+  - **`<MDX>` 组件：** 用 `<MDX>` 包裹内容，即可在 JSX 表达式（如条件内容）中渲染 Markdown 格式。
+  - **组件支持 `className`：** 内置组件现在接受 `className` 属性，你可以为 accordion、callout、steps、tabs、代码块等应用自定义样式。
+  - **私有页面搜索：** 编辑器搜索现在包含你的私有页面，并可直接从搜索面板打开结果。参见[私有页面](/zh/editor/pages#private-pages)。
+  - **Agent 回复提及：** 在评论、建议或回复中提及 `@mintlify`，编辑器 agent 会在同一会话串中回复，私有页面也支持。参见[向 Mintlify agent 提问](/zh/editor/collaborate#ask-the-mintlify-agent)。
+
+<div id="improvements">
+  ## 改进
+</div>
+
+  - **重新设计的自动化运行页：** 运行标签页现在以分组信息流展示每次运行的结果，包括 pull request、被修改的页面和失败项，并提供状态筛选和待审查标识。自动化配置从浮层面板改为独立的配置页面。参见[管理自动化](/zh/automations/manage)。
+  - **`mint analytics`：** 在 CLI 中查看流量统计、搜索查询、反馈和 assistant 对话。参见 [`mint analytics`](/zh/cli/commands#mint-analytics)。
+  - **可点击的 agent 提问：** 当编辑器 agent 提出澄清问题时，点击选项即可回答，无需输入。
+  - **SVG 附件：** 可以在编辑器 agent 消息中附加 SVG 文件。参见[附加文件](/zh/editor/agent#attach-files)。
+  - **更快的分支操作：** 在编辑器中创建分支会立即切换过去，编辑器会引导你完成分支保护规则，pull request 状态更新通过 webhook 到达而不再轮询。
+  - **数学公式编辑：** 编辑器中的数学表达式现在会在你输入时实时更新渲染预览。
+  - **组件属性面板：** 编辑器的组件属性面板采用全新设计，并自动保存你的更改。
+  - **可发现的 `llms.txt` 索引：** 根 `llms.txt` 现在链接到 `/_llms` 下的分节索引，可选链接按导航范围建立索引。参见 [llms.txt](/zh/ai/llmstxt)。
+  - **Universal Search MCP 速率限制：** 速率限制提高到每日 5,000 次请求。
+  - **组织切换：** 打开属于你另一个组织的编辑器链接时，现在会提示你切换组织，而不是显示错误。
+
+<div id="bug-fixes">
+  ## 错误修复
+</div>
+
+  - **Safari 媒体：** 上传到文档的图片和视频现在能在 Safari 中正确加载。
+  - **Accordion：** accordion 内的 HTML 表格现在会正常渲染而不是被丢弃。
+  - **代码组：** `CodeGroup` 中的可展开代码块不再超出折叠高度持续增高。
+  - **iOS 缩放：** 在 iOS 上聚焦搜索和 assistant 输入框不再放大页面。
+  - **Favicon：** 使用自定义基础路径的部署中，favicon URL 能正确解析。
+  - **API playground：** 枚举数组项渲染其值，而不是类型标签。
+  - **`llms.txt` 语言：** 特定语言的 `llms.txt` 路由限定在其语言范围内，优先使用默认语言，并规范化了 `llms-full.txt` 的标题和链接。
+  - **`mint format`：** CLI 格式化输出现在与编辑器一致，格式化文件不再产生多余的 diff。
+  - **编辑器修复：** 移除页面图标会持久保存，在工具栏下拉菜单中选择后焦点回到页面，删除当前打开的页面会重定向而不是显示过期视图。
+  - **Assistant widget：** widget 会在配置过期前刷新配置，长时间打开的页面仍能正常使用 assistant。
+
+</Update>
+
 <Update label="2026年8月21日" tags={["新版本","改进","错误修复"]} rss={{ title:"Branches v2、Slack 触发的 automations 与可自定义的 SDK reference 页面" }}>
 
 <div id="editor-and-collaboration">