mintlify · ethanpalm · Aug 26, 2026 · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026
diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt
@@ -32,13 +32,13 @@ Atlassian
 (?i)auth
 Auth0
 authed
-autocommit
+autocommit(s|ed|ing)?
 autofocuses
 (?i)autogenerat(e|ed|ing)?
 (?i)automations?
 (?i)automerge
 (?i)autoplay
-autosave(s|d)?
+autosav(e|es|ed|ing)
 AVIF
 AWS
 axios
@@ -148,6 +148,7 @@ DORA
 (?i)drilldown
 DRY
 DynamoDB
+dotfile(s)?
 EasyList
 ECS
 EdDSA

diff --git a/changelog.mdx b/changelog.mdx
@@ -9,8 +9,8 @@
 
   ## 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/branching-and-publishing).
-  - **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#create-pull-requests-as-drafts-by-default) page.
+  - **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#create-draft-pull-requests-by-default) 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.
   - **Page access and comments:** Request edit access to a private or protected page from the editor and review requests in an approval modal. Comment cards now show profile pictures, and @mentions link to the mentioned user.
@@ -24,12 +24,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 +39,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 +47,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 +60,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 +84,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,14 +104,14 @@
  - **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
 
   - **Faster live previews:** Live previews load much faster on first open, new pages and `docs.json` changes appear sooner, and CSS and theme edits now update in real time.
   - **Live preview in the editor:** Live previews open in an editor pane instead of a new tab, and site settings and the editor agent are available while you preview.
-  - **Authenticated live previews:** Preview drafts of pages behind authentication from the editor [live preview](/editor/live-preview).
+  - **Authenticated live previews:** Preview drafts of pages behind authentication from the editor [live preview](/editor/review#live-preview).
   - **OpenAPI 3.1 file uploads:** The API playground now recognizes OpenAPI 3.1 files uploaded to `FileInput` fields, and file inputs support drag-and-drop. See [OpenAPI setup](/api-playground/openapi-setup) for more information.
   - **Markdown mode:** Use the `/` menu in Markdown mode, copy content as Markdown, and pasted Markdown in visual mode formats automatically.
   - **Assistant analytics:** The assistant analytics view has more context and filtering than the previous version.
@@ -132,8 +132,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 +168,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,13 +193,13 @@

  ## 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
 
   - **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches.
-  - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keyboard shortcuts <kbd>Option</kbd> + <kbd>C</kbd> or <kbd>Option</kbd> + <kbd>S</kbd> to comment on or suggest changes to selected text.
+  - **More ways to collaborate:** Start [comment threads](/editor/collaborate#comments) on an entire page, mention yourself to leave a reminder, and use keyboard shortcuts <kbd>Option</kbd> + <kbd>C</kbd> or <kbd>Option</kbd> + <kbd>S</kbd> to comment on or suggest changes to selected text.
   - **Faster, more available editing:** The editor renders without waiting for the Git file tree and people without GitHub write access can use the editor.
 
   ## Automations, integrations, and Slack
@@ -255,8 +255,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 +281,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 +353,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 +368,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 +384,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 +433,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 +455,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 +471,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 +482,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 +494,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 +520,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 +535,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 +548,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 +562,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 +594,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 +606,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 +619,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 +636,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 +667,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 +703,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 +731,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 +742,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 +754,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 +781,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 +822,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 +862,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 +878,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 +901,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 +918,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/live-preview). Embedded mp4, webm, and mov files now render correctly during local development.
+  - 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 +969,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 +994,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 +1100,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 +1169,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 +1198,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 +1290,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 +1300,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 +1321,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 +1382,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

@@ -1412,11 +1412,11 @@
 
   ## Web editor improvements
 
-  - Added [shareable preview links](/editor/branching-and-publishing#access-and-share-a-preview) from the editor toolbar.
-  - Updated [publishing workflow](/editor/branching-and-publishing) to support one-click publishing or creating pull requests.
+  - Added [shareable preview links](/editor/review#preview-deployments) from the editor toolbar.
+  - 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 +1434,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 +1450,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 +1459,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 +1483,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 +1497,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 +1506,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 +1520,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 +1539,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 +1550,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 +1568,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 +1590,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 +1616,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 +1631,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 +1654,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 +1769,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 +1792,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 +1831,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 +1867,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 +1890,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 +1901,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 +1932,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 +1953,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 +1971,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 +1989,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 +2033,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 +2054,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 +2064,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 +2080,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 +2095,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 +2161,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 +2182,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 +2210,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 +2227,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 +2255,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 +2263,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 +2282,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 +2296,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 +2320,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 +2353,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 +2369,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 +2401,7 @@
    "mode": "auto"
  }
  ```

  ## Advanced Footer

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

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

  <Frame>
@@ -2450,11 +2450,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 +2475,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 +2487,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 +2505,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 +2527,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 +2537,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 +2550,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 +2584,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/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
@@ -480,7 +480,7 @@
 </ParamField>

 <ParamField path="apiPlaygroundInputs" type="object">
  Prefills API playground fields with user-specific values. When a user authenticates, these values populate the corresponding input fields in the API playground. Users can override prefilled values, and their overrides persist in local storage.

  Mintlify applies only values that match the current endpoint's security scheme.

@@ -518,4 +518,4 @@
 | [skill.md](/ai/skillmd) | Full support | Not supported | Not supported |
 | [Sitemap](/optimize/seo#sitemaps-and-robotstxt-files) | Full support | Available behind authentication, but excludes pages in groups | Available behind authentication, but excludes pages in groups |
 | [robots.txt](/optimize/seo#sitemaps-and-robotstxt-files) | Full support | Available behind authentication | Available behind authentication |
-| [Live preview](/editor/live-preview) | Full support | Supported for Mintlify authentication | Supported for Mintlify authentication |
+| [Live preview](/editor/review#live-preview) | Full support | Supported for Mintlify authentication | Supported for Mintlify authentication |
diff --git a/docs.json b/docs.json
@@ -121,15 +121,11 @@
                     "root": "editor/index",
                     "pages": [
                       "editor/tutorial",
-                      "editor/git-essentials",
                       "editor/pages",
-                      "editor/navigation",
-                      "editor/live-preview",
-                      "editor/branching-and-publishing",
-                      "editor/comments",
-                      "editor/suggestions",
+                      "editor/publish",
+                      "editor/review",
+                      "editor/collaborate",
                       "editor/agent",
-                      "editor/configurations",
                       "editor/settings",
                       "editor/keyboard-shortcuts"
                     ]

diff --git a/editor/agent.mdx b/editor/agent.mdx
@@ -10,17 +10,9 @@
 
 ## Open the agent
 
-{/* vale Mintlify.FirstPerson = NO */}
 Click **Ask agent** in the editor toolbar, or press <kbd>Cmd</kbd> + <kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows).
 
-To close the panel, click the **X** button in the panel header or press <kbd>Cmd</kbd> + <kbd>I</kbd> again.
-{/* vale Mintlify.FirstPerson = YES */}
-
-## Send a message
-
-Type your request in the chat box at the bottom of the panel and press <kbd>Enter</kbd> or click the <Icon icon="arrow-up" /> send button.
-
-Type <kbd>@</kbd> to mention a specific page. The agent focuses on that page when processing your request. If you don't mention a page, the agent uses the page you currently have open.
+Type <kbd>@</kbd> to mention a specific page, and the agent focuses on it. Without a mention, it uses the page you currently have open.
 
 Example prompts:
 
@@ -39,20 +31,20 @@
 - **Documents**: PDF
 - **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more

 Maximum size: 5 MB per file, except SVG files, which are limited to 256 KB. Maximum: 10 files per message.

 Mintlify strips scripts and other active content from SVG files before the agent reads them.
 
 ## Add a selection to the agent
 
-In visual mode, select text on a page. A floating toolbar appears over the selection. Click **Add to agent** to send the selected text to the agent as context.
+In visual mode, select text and click **Add to agent** in the floating toolbar to send it to the agent as context.
 
 ## Ask for comments and suggestions
 
 The agent edits content directly by default. To get feedback without immediately changing the page, explicitly ask the agent to review the page, leave comments, or make suggestions.
 
-- [Suggestions](/editor/suggestions) propose a specific replacement that you can accept or reject. The original text remains visible with a strikethrough until you decide, and the agent can include an explanation in the suggestion thread.
-- [Comments](/editor/comments) leave feedback or a question anchored to specific text without changing the page.
+- [Suggestions](/editor/collaborate#suggestions) propose a specific replacement that you can accept or reject. The original text remains visible with a strikethrough until you decide, and the agent can include an explanation in the suggestion thread.
+- [Comments](/editor/collaborate#comments) leave feedback or a question anchored to specific text without changing the page.
 
 Example prompts:
 
@@ -64,7 +56,7 @@
 
 ## Review what the agent changed
 
-As the agent edits your pages, a **Changed files** panel appears in the chat. Expand it to see a list of every file modified in the session. Click any file to open it in diff view and compare the agent's changes against the original.
+A **Changed files** panel appears in the chat as the agent works. Expand it to see every file modified in the session, and click any file to compare the changes against the original in diff view.
 
 ## What the agent can do