mintlify · dks333 · Sep 24, 2026 · Sep 23, 2026
diff --git a/.mintlify/assistant/skills/git-revalidation/skill.mdx b/.mintlify/assistant/skills/git-revalidation/skill.mdx
@@ -1,20 +1,20 @@
 ---
 name: "git-revalidation"
 description: "Use this skill when a user reports that GitHub-dependent features have stopped working after they changed their repository from private to public or vice versa — Suggest Edits isn't showing on their docs, PR previews aren't generating, or branch options appear stale. Also applies when the Git connection appears stale or broken."
 ---

 # Revalidate the Git connection

 When a repository's visibility changes (private to public or public to private), Mintlify's cached understanding of the repo's permissions becomes outdated. Features that depend on the GitHub connection — Suggest Edits, PR previews, branch syncing — can appear broken until the cache catches up to the new visibility state.

 Before recommending revalidation, check which direction the visibility changed:

 - **Private to public**: revalidation restores affected features, including Suggest Edits.
 - **Public to private**: Suggest Edits is only available for public GitHub repositories, so it is expected to disappear and revalidation will not restore it. Revalidation still fixes other stale-connection symptoms like PR previews or branch options.
 
 Walk the user through these steps:
 
-1. Go to the [Git Settings page](https://app.mintlify.com/settings/deployment/git-settings).
+1. Go to the [Git Settings page](https://app.mintlify.com/settings/project/git-settings).
 2. Press `Cmd + Shift + Enter` (Mac) or `Ctrl + Shift + Enter` (Windows).
 
 This keyboard shortcut revalidates the Git connection. Mintlify re-checks the repository's visibility and permissions, which restores affected features.

diff --git a/agent-context/context/skills/mintlify/reference/navigation.md b/agent-context/context/skills/mintlify/reference/navigation.md
@@ -307,7 +307,7 @@ Version properties:
 
 Each language entry can include its own `banner`, `footer`, and `navbar` configuration overrides.
 
-To redirect visitors from the site root to the language matching their browser's `Accept-Language` header, enable **Auto-route to preferred language** on the dashboard Add-ons page (`https://app.mintlify.com/settings/deployment/addons`). Mintlify only redirects visits to the site root. If a visitor picks a language with the language switcher, Mintlify remembers their choice and stops auto-routing them. If no published language matches the visitor's browser preferences, Mintlify serves the default language.
+To redirect visitors from the site root to the language matching their browser's `Accept-Language` header, enable **Auto-route to preferred language** on the dashboard Add-ons page (`https://app.mintlify.com/settings/project/addons`). Mintlify only redirects visits to the site root. If a visitor picks a language with the language switcher, Mintlify remembers their choice and stops auto-routing them. If no published language matches the visitor's browser preferences, Mintlify serves the default language.
 
 ## OpenAPI in navigation
 

diff --git a/agent/index.mdx b/agent/index.mdx
@@ -52,7 +52,7 @@ For deployments connected to your own Git provider, click **Configure Slack** on
 
 ## Connect repositories as context
 
-The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the [GitHub App settings](https://github.com/apps/mintlify/installations/new). For GitLab, use [Git Settings](https://app.mintlify.com/settings/deployment/git-settings).
+The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the [GitHub App settings](https://github.com/apps/mintlify/installations/new). For GitLab, use [Git Settings](https://app.mintlify.com/settings/project/git-settings).
 
 ## Use a static IP for Git requests
 

diff --git a/assistant/narration.mdx b/assistant/narration.mdx
@@ -13,7 +13,7 @@

 Mintlify generates narration on demand from your published content, so audio always matches the content of the page. When a page changes, the next listener triggers a fresh generation.

 The **Listen to this page** player only appears on pages with narratable content. Very short pages and pages that are mostly non-prose cannot be narrated. Narration is not available for deployments that require authentication to access.

 Narration uses credits from your organization's shared credit balance. Each generation costs 50 credits. Replays of the same page version are free. See [Credit pricing](/credits) for details. Track usage on the [Usage](https://app.mintlify.com/settings/organization/usage) page of your dashboard.

@@ -21,9 +21,9 @@

 Narration reads the page title, description, and body in order. Mintlify announces steps, tabs, callouts, and accordions with short spoken cues. Narration skips code blocks, tables, media, and API fields.

 While audio plays, Mintlify highlights the sentence being read and scrolls to keep it in view. If a reader scrolls away, automatic scrolling stops and the audio continues. Readers can pause playback, track progress, and change playback speed from 0.8x to 2x. Opening another page stops the current narration.
 
 ## Enable narration
 
-1. Navigate to the **Narration** section of the [General](https://app.mintlify.com/settings/deployment/general) settings in your dashboard.
+1. Navigate to the **Narration** section of the [General](https://app.mintlify.com/settings/project/general) settings in your dashboard.
 2. Enable **Page narration**.
diff --git a/assistant/widget.mdx b/assistant/widget.mdx
@@ -9,7 +9,7 @@

 export const WidgetCodeBlock = ({ children, ...props }) => (
  <CodeBlock {...props}>{children}</CodeBlock>
 );

 The [assistant](/assistant) answers questions on your Mintlify site. To embed the same capability on another site or web app, use the widget. The widget gives your users access to AI chat trained on your content, wherever they use your product. Embed it in your dashboard, marketing site, support portal, or elsewhere.

@@ -23,7 +23,7 @@
 
 ## Enable the widget
 
-1. Navigate to your deployment's [Widget](https://app.mintlify.com/settings/deployment/widget) page.
+1. Navigate to your deployment's [Widget](https://app.mintlify.com/settings/project/widget) page.
 2. Enable the widget.
 3. Add allowed origins where you embed the widget.
 4. Copy the widget ID.
@@ -33,7 +33,7 @@
 Use the playground to configure the presentation, visual options, and observer hooks for your widget. The installation code block updates as you change each option.
 
 <Info>
-  Replace `YOUR_WIDGET_ID` in the generated code with the widget ID from the [Widget](https://app.mintlify.com/settings/deployment/widget) page of your dashboard.
+  Replace `YOUR_WIDGET_ID` in the generated code with the widget ID from the [Widget](https://app.mintlify.com/settings/project/widget) page of your dashboard.
 </Info>
 
 After you add the generated code to your site, reload the page. Confirm the trigger appears, then click it and send a test question to verify the connection.
@@ -285,7 +285,7 @@

 Conversation snapshots remain private to the widget. Each method resolves to `void`.

 ## Content Security Policy

 If your site uses a Content Security Policy, allow the origins required by your enabled widget features:

@@ -296,8 +296,8 @@
 | `connect-src`                                | `https://api.mintlify.com`          | Configuration, messages, and feedback |
 | `connect-src`                                | `https://ph.mintlify.com`           | Internal widget analytics             |
 | `font-src`                                   | `https://widget.mintlify.com`       | Optional bundled Inter font           |
 | `script-src`                                 | `https://js.hcaptcha.com`           | hCaptcha bot protection               |
 | `connect-src` and `frame-src`                | `https://*.hcaptcha.com`            | hCaptcha bot protection               |

 A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected style sheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization.


diff --git a/changelog.mdx b/changelog.mdx
@@ -25,7 +25,7 @@

  - **@mentions:** Type `@` in a page to mention a teammate. Mentioned teammates get a notification.
  - **Profile picture uploads:** Upload a profile picture from your account settings. It appears on comments, mentions, and collaborator avatars.
  - **Workspace folder icons:** Edit the icon on a workspace folder from its menu. Folder metadata is preserved when you move or rename it.
  - **Emoji favicons:** A new **Emojis** tab in the icon picker lets you set an emoji as a page icon, and emoji icons render as the editor tab favicon.
  - **Reorder shared and starred pages:** Drag pages in **Shared with me** and **Starred** to set the order you want. The order syncs across your devices.
  - **Version history redesign:** The version history panel has a refreshed layout that's easier to scan when comparing revisions.
@@ -34,7 +34,7 @@
  ## Dashboard

  - **Rebuilt Activity page:** The Activity page has a new layout and shows richer details.
  - **SSO login route:** A new login route detects SSO configuration for your email domain and sends you to the right identity provider. The SSO connection limit is raised to 25.
  - **Assistant layout settings:** Deployment settings include options for the assistant layout so you can control how the assistant appears on your published site.

  ## Analytics
@@ -50,15 +50,15 @@

  ## Bug fixes

  - **Editor publishing:** Pending edits are saved before publishing, deleted page titles show in the publish panel, publish retries when the branch lock is held, GitHub same-path replaces succeed, GitLab create collisions no longer break publish, and rows the server keeps after publish are preserved.
  - **Editor:** Language switcher options are disabled for pages without a translation, new page paths update until the first commit, slash commands rank by relevance, frontmatter edits are preserved during Git sync, source-mode comments no longer show false conflicts, and the page title is preserved across navigation.
  - **Automations:** Folder selection and topic search work correctly in the create flow, automatic conflict resolution skips mandatory PR mode when needed, and the trigger options popover collapses cleanly.
  - **OpenAPI and API playground:** Reverse-proxy guides render for sites with a base path, schema validation errors stay on one line, and locally-ignored OpenAPI specs are marked stale on full updates.
  - **Client and hosting:** RSS URLs no longer duplicate base paths, custom and frame pages render without a layout shift on load, and color swatches pick their theme value in CSS.

 </Update>

 <Update label="September 11, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Simplified credit pricing, OpenAPI Overlays, and more" }}>

  ## AI credit pricing updates

@@ -68,17 +68,17 @@

  ## OpenAPI Overlays

  - **Transform a spec:** Use OpenAPI Overlays to rename paths, replace server URLs, or remove internal endpoints without editing the specification file. Overlays apply after a specification is parsed and before it is validated, so generated endpoint pages, navigation, `openapi` frontmatter, and `mint validate` all use the transformed document. See [Transform your spec with overlays](/api-playground/openapi-setup#transform-your-spec-with-overlays).
  - **Overlay Specification 1.0 and 1.1:** Write `update`, `remove`, and `copy` actions that select nodes with [RFC 9535 JSONPath](https://www.rfc-editor.org/rfc/rfc9535) expressions. See [Create an overlay document](/api-playground/openapi-setup#create-an-overlay-document).
  - **Reference or auto-discover overlays:** Add an `overlays` property anywhere your `docs.json` accepts `openapi`, using a relative path or a URL. Or skip the configuration: an overlay with an `extends` field pointing at your specification is discovered automatically. See [Auto-discover overlays](/api-playground/openapi-setup#auto-discover-overlays).

  ## Editor and collaboration

  - **Recent and starred private pages:** The **Workspace** tab of the editor now lists the private pages you opened most recently and the ones you star from a page's menu. Both lists sync across your devices and stay the same on every branch. Each section stays hidden until it has something in it. You can reorder these sidebar groups by dragging them to create your preferred workspace layout.
  - **Move and duplicate private pages:** Move a private page into a workspace folder from its document or sidebar menu, duplicate a private page from the same menu, or leave a private page you were invited to. When you promote a private page, its images and videos move with it and inline references are rewritten. See [Private pages](/editor/pages#private-pages).
  - **Comments panel:** Open a document-wide comments panel to review open and resolved threads for the current page. Source mode now supports comments the same as visual mode. See [Comments](/editor/collaborate#comments).
  - **Resize table columns:** In visual mode, drag a column border to resize it. The editor converts the table to HTML and writes the `<colgroup>` widths for you. See [Tables](/create/list-table).
  - **Site settings in the sidebar:** Site configuration pages open directly from the editor sidebar instead of a modal, and workspace settings navigation has been reorganized to match.
  - **Page icons as tab favicons:** The editor tab favicon now uses the page's icon. Page and navigation icon frontmatter accept emoji values.
  - **Editor agent integrations (Enterprise):** The editor agent can use connected third-party apps as read-only tools while researching and editing. See [Use connected integrations](/editor/agent#use-connected-integrations).

@@ -90,7 +90,7 @@
  ## Published sites

  - **Image viewer:** Clicking an image opens a rebuilt full-size viewer with smoother animation and labeled controls for screen readers.
  - **Search ranking:** Search ranks page-title matches higher, so exact-title lookups surface first.

  ## Dashboard

@@ -100,9 +100,9 @@
  ## Git and integrations

  - **Non-Markdown files sync in the editor:** Editor branches now sync non-MDX text files, so changes to config files and other plain-text assets round-trip through the editor.
  - **GitLab editor branches:** GitLab pushes sync into editor branches in real time, contributors show on the branch dropdown, and force pushes are detected. Git-only branches now appear in the editor branch dropdown so you can switch to a branch that was created outside the editor.
  - **Editor branch dropdown:** The branch dropdown is now a per-user editor setting. Turn it on from your editor settings to switch branches from the editor.
  - **Default ignored patterns:** `.vscode` and `.cursor` are ignored by default, and `mint dev` skips ignored directories when it crawls your project. See [Default ignored patterns](/organize/mintignore#default-ignored-patterns).

  ## API playground

@@ -110,14 +110,14 @@

  ## Bug fixes

  - **Preview deployments:** GitHub preview deployments are pinned to the triggering commit, preview URLs stay stable across rebuilds, and preview comments refresh after each rebuild.
  - **Custom domains and 404s:** Custom hostnames Cloudflare no longer serves return `not_found`, MCP analytics resolve custom domains to their canonical subdomain, and Markdown 404s include recovery guidance and discovery headers.
  - **Components:** `RequestExample` and `ResponseExample` code blocks no longer disappear on small screens.
  - **Editor fixes:** Creating a branch no longer leaves a stuck skeleton, pull-request link redirects no longer double-encode branch names, `saving` rows match the server, resizing no longer loops, and frontmatter loads only after the document connects.
  - **Publishing:** Content-less create actions retire after publish so they cannot block later publishes, publish retries when the branch lock is held instead of erroring immediately, and GitHub commit failures report clearer messages.
  - **Dashboard fixes:** SSO configuration resets when you remove a connection, only verified domains can be selected when SSO is configured, and the page header restores the **Add description** affordance.
  - **Auth and account:** Password reset is asynchronous and rate limited, dev org rate limits are raised, and a new-account flag lets the dashboard fire the correct sign-up event.
  - **OpenAPI:** Memory usage during OpenAPI candidate detection is reduced, API reference pages slice the schema graph to the page's target, and `$ref` prefixes and array entries resolve correctly in overlays under base paths and mounts.

 </Update>

@@ -132,9 +132,9 @@
  ## Editor and collaboration

  - **Collaborative source mode:** Source mode now supports real-time collaboration. See your teammates' cursors as they work on the same branch as you. Frontmatter edits sync live across visual and source mode. See [Real-time editing](/editor/collaborate#real-time-editing).
  - **Comment reactions:** React to a comment with an emoji to acknowledge it without replying. Hover over a reaction to see who reacted, and reacting to someone else's comment notifies its author. See [Comments](/editor/collaborate#comments).
  - **Selective publish:** Select individual changes in the publish menu to publish part of your pending work instead of everything at once.
  - **Media on private pages:** Upload images and videos to private pages. Private media is served only to people who can open the page, and it is removed when the page is deleted.
  - **Editor polish:** Search results show page titles and reveal the file in the sidebar, the sidebar lists only Markdown pages by default, the share dialog searches recipients by email address, the emoji suggestion menu has better search relevance, and the agent panel stays available in site settings.

  ## Automations
@@ -152,8 +152,8 @@

  ## Authoring

  - **`mint test`:** Generate tests for the code blocks in your docs from the CLI. Runs are saved so you can revisit past reports. See [`mint test`](/cli/commands#mint-test).
  - **`<MDX>` improvements:** Headings inside `<MDX>` blocks merge into the page's table of contents, `## Title {#id}` anchors work at any indent, and code blocks inside `<MDX>` behave like code blocks at the page root. See [MDX](/components/mdx).
  - **Markdown in component titles:** Component titles, such as accordion titles, support inline Markdown formatting like code and bold.
  - **Table column widths:** HTML tables honor the `<colgroup>` widths you author.

@@ -206,19 +206,19 @@

  ## Docs and agents

  - **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).
  - **Index MCP rate limit:** The daily rate limit for the Mintlify Index MCP server is raised to 5,000 requests. See [Index MCP reference](/search-index/mcp).
  - **Publishing permissions for AI apps:** Changing whether your MCP server pushes directly to your deploy branch now requires an admin role. Editors see the setting as read-only.

  ## Bug fixes

  - **Safari media:** Images and videos 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.
@@ -229,7 +229,7 @@

  ## 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.
@@ -244,12 +244,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.
@@ -259,7 +259,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.
@@ -267,7 +267,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

@@ -280,18 +280,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.
+  - **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/project/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

@@ -304,15 +304,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>
@@ -324,7 +324,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
@@ -352,8 +352,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>

@@ -388,8 +388,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.

@@ -413,7 +413,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
@@ -475,8 +475,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
@@ -501,9 +501,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.

@@ -513,7 +513,7 @@
 
   ## Custom domain, subdomain, and subpath hosting
 
-  - **Improved setup for custom domain, subdomain, and subpath hosting:** Updated UI and steps on the [Domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page. See [Custom domain](/customize/custom-domain) and [Host at a subpath](/deploy/docs-subpath) for more information.
+  - **Improved setup for custom domain, subdomain, and subpath hosting:** Updated UI and steps on the [Domain setup](https://app.mintlify.com/settings/project/custom-domain) page. See [Custom domain](/customize/custom-domain) and [Host at a subpath](/deploy/docs-subpath) for more information.
 
   ## Editor comments, suggestions, and performance
 
@@ -573,14 +573,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

@@ -588,10 +588,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.

@@ -604,45 +604,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.
@@ -653,19 +653,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.
@@ -675,11 +675,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>

@@ -691,9 +691,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.
@@ -702,10 +702,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

@@ -714,7 +714,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.
@@ -740,7 +740,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
@@ -755,7 +755,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>

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

@@ -782,7 +782,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
@@ -814,11 +814,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.
@@ -826,12 +826,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.
@@ -839,7 +839,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
@@ -856,19 +856,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.

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

@@ -906,7 +906,7 @@
   - Mermaid diagrams in the editor now support a fullscreen mode for easier editing of complex diagrams.
   - The custom domain dashboard now displays both verification `TXT` records (`_acme-challenge` and `_cf-custom-hostname`) with live verification status, so you can confirm DNS is correct before pointing your `CNAME` at Mintlify. See [custom domain](/customize/custom-domain) for more details.
   - TLS certificate provisioning for [custom domains](/customize/custom-domain#automatic-tls-provisioning) is now handled directly by Mintlify.
-  - GitLab-connected deployments can now revalidate their Git source from the [Git settings](https://app.mintlify.com/settings/deployment/git-settings) page by clicking the **Active** badge, useful when branch options or configuration appear stale.
+  - GitLab-connected deployments can now revalidate their Git source from the [Git settings](https://app.mintlify.com/settings/project/git-settings) page by clicking the **Active** badge, useful when branch options or configuration appear stale.
   - The [feedback dashboard](/optimize/feedback) detailed feedback view now only shows submissions that include written comments, making qualitative feedback easier to scan.
 </Update>
 
@@ -923,7 +923,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.

@@ -951,7 +951,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.
@@ -962,7 +962,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).
@@ -974,20 +974,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.
@@ -1001,7 +1001,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

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

@@ -1082,11 +1082,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
@@ -1098,19 +1098,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.
@@ -1121,7 +1121,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.
@@ -1138,8 +1138,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.
@@ -1189,7 +1189,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

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

@@ -1320,9 +1320,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

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

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

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

@@ -1520,17 +1520,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.

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

@@ -1602,7 +1602,7 @@
  You can now customize your 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

@@ -1636,7 +1636,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.
@@ -1654,8 +1654,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. The bot answers questions in real-time based on your documentation, so it provides accurate, up-to-date answers to your community.
@@ -1670,7 +1670,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
@@ -1679,11 +1679,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>

@@ -1703,7 +1703,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" }}>
@@ -1717,8 +1717,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
@@ -1726,7 +1726,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" }}>
@@ -1740,7 +1740,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.

@@ -1759,7 +1759,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.
@@ -1770,7 +1770,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" }}>
@@ -1788,14 +1788,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
@@ -1810,7 +1810,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
@@ -1836,14 +1836,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.
@@ -1851,7 +1851,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

@@ -1874,7 +1874,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
@@ -1989,13 +1989,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
@@ -2012,7 +2012,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

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

@@ -2087,7 +2087,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" }}>
@@ -2110,7 +2110,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
@@ -2121,7 +2121,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
@@ -2152,16 +2152,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" }}>
@@ -2173,13 +2173,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
@@ -2191,7 +2191,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" }}>
@@ -2209,7 +2209,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

@@ -2253,8 +2253,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

@@ -2274,7 +2274,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`
@@ -2284,8 +2284,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>
@@ -2300,7 +2300,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

@@ -2315,7 +2315,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
@@ -2379,11 +2379,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.
@@ -2400,13 +2400,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>
@@ -2428,7 +2428,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)
@@ -2445,7 +2445,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>

@@ -2473,7 +2473,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).
@@ -2481,7 +2481,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>
@@ -2500,10 +2500,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
@@ -2514,7 +2514,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:
@@ -2538,26 +2538,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).

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

@@ -2587,7 +2587,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.
@@ -2619,7 +2619,7 @@
    "mode": "auto"
  }
  ```

  ## Advanced Footer

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

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

  <Frame>
@@ -2668,11 +2668,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>
@@ -2693,11 +2693,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`.
@@ -2705,15 +2705,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.
@@ -2723,19 +2723,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>
@@ -2745,7 +2745,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.
@@ -2755,7 +2755,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.
@@ -2768,8 +2768,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.
@@ -2802,11 +2802,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/cli/commands.mdx b/cli/commands.mdx
@@ -98,13 +98,13 @@

 | Client | Global configuration | Project configuration |
 | --- | --- | --- |
 | Claude Code | `~/.claude.json` | `.mcp.json` |
 | Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
 | VS Code | User `mcp.json` | `.vscode/mcp.json` |
 | Codex | `~/.codex/config.toml` | `.codex/config.toml` |
 | OpenCode | `~/.config/opencode/opencode.json` | `opencode.json` |
 | Windsurf | `~/.codeium/windsurf/mcp_config.json` | Global only |
 | Zed | User `settings.json` | `.zed/settings.json` |

 ---

@@ -209,10 +209,10 @@

 Add the `TXT` records first, then add the `CNAME` once the verification records validate. See [Custom domain](/customize/custom-domain) for full DNS setup instructions, apex domain requirements, and TLS provisioning details.

 If the command fails with `Domain is already in use by another deployment in your organization` or `Domain is already claimed by another organization`, the domain is bound to another Mintlify deployment. See [Add domain fails with "Domain is already claimed by another organization"](/help-center/domain-already-claimed-by-another-organization) to release it and re-add it.
 
 <Note>
-  If some `TXT` records are still generating when the command exits, check the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard for the remaining values.
+  If some `TXT` records are still generating when the command exits, check the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page in your dashboard for the remaining values.
 </Note>
 
 When you pass `--basePath`, the CLI saves the base path after registering the domain. The new path takes effect on your next deploy, and your site continues serving from the current path until then. The `CNAME` sends all traffic on the domain to Mintlify, so only add it if the domain hosts nothing else. Otherwise, keep your existing DNS and set up a reverse proxy to Mintlify for the base path. See [Host docs at a subpath](/deploy/docs-subpath) for provider-specific guides.
@@ -256,7 +256,7 @@

 ### `mint analytics stats`

 Display top-line KPIs for a date range: views, visitors, searches, feedback, and assistant usage. The output reports human and agent traffic separately.

 ```bash
 mint analytics stats [flags]
@@ -405,7 +405,7 @@
 | `--check-redirects` | Also check that redirect destinations in `docs.json` resolve to valid paths. |
 | `--check-snippets` | Also check links inside `<Snippet>` components. |

 Pass `--files` to limit the check to specific pages. This is useful for validating a single page you just edited or scoping checks to a directory in CI. When `--files` is set with `--check-external`, only external URLs on the selected pages are fetched.

 ```bash
 # Check a specific page
@@ -603,13 +603,13 @@
 mint format
 ```

 Run the command from the root of your docs project. It walks every subdirectory, skipping paths matched by `.gitignore` and any Mintlify ignore rules. Files that already match the canonical output are left untouched.

 <Tip>
  Running `mint format` can result in many changes depending on the size of your project. To avoid merge conflicts and introducing changes to other in progress work, first resolve all important pending branches. Then create a new branch for formatting changes and run `mint format` on that branch.
 </Tip>

 When it finishes, the command prints how many MDX files were reformatted and how many failed to parse. If any file fails, the command exits with code `1` and prints the file path and error, so you can run it in CI to enforce consistent formatting. See [Install in CI](/cli/install#install-in-ci) for an example pipeline.

 ---

@@ -663,7 +663,7 @@

 ## Telemetry

 The CLI collects usage telemetry to help improve Mintlify. Telemetry data includes the command name, CLI version, operating system, and architecture. If you are logged in, telemetry events also include your account email address. Logged-out usage stays anonymous, and logging out removes your stored email. Mintlify does **not** collect project content or file paths.

 By default, the CLI collects telemetry data. You can opt out at any time using the `--telemetry` flag:


diff --git a/create/personalization.mdx b/create/personalization.mdx
@@ -16,9 +16,9 @@ Personalization uses a shared session, JWT, or OAuth to identify visitors withou
 
 ## Configure personalization
 
-Enable personalization on the [General](https://app.mintlify.com/settings/deployment/general) page of your dashboard. Personalization is mutually exclusive with full authentication. JWT and OAuth authentication include personalization features.
+Enable personalization on the [General](https://app.mintlify.com/settings/project/general) page of your dashboard. Personalization is mutually exclusive with full authentication. JWT and OAuth authentication include personalization features.
 
-1. Navigate to the [General](https://app.mintlify.com/settings/deployment/general) page of your dashboard.
+1. Navigate to the [General](https://app.mintlify.com/settings/project/general) page of your dashboard.
 2. In the **Personalization** section, select shared session, JWT, or OAuth.
 3. Configure your selected personalization method.
 4. Click **Save changes**.

diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx
@@ -28,7 +28,7 @@ You can host your documentation at the root of a domain, a subdomain, or a subpa
 
 ## Add your custom domain
 
-1. Navigate to the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard.
+1. Navigate to the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page in your dashboard.
 2. To host at a subpath, enable the **Host at** toggle and enter your base path, like `/docs`.
 3. Enter your domain name. For example, `docs.example.com` or `example.com`.
 4. Click **Add domain**.
@@ -134,15 +134,15 @@ If you need zero downtime during migration, set the `CNAME` record's proxy statu
 
 `TXT` records typically validate within five minutes. If your domain is still pending validation after adding the verification `TXT` records, manually retry validation from your dashboard.
 
-1. Navigate to the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard.
+1. Navigate to the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page in your dashboard.
 2. Find your pending custom domain.
 3. Click **Retry validation**.
 
 Only retry validation after you confirm that your DNS records are correct. Repeated retries with incorrect records do not speed up validation.
 
 ## Remove a custom domain
 
-To remove a custom domain, click the <Icon name="trash-2" /> remove icon next to your domain on the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page and confirm the removal. Existing links to the domain may break, and re-adding the domain may require reconfiguring your DNS records.
+To remove a custom domain, click the <Icon name="trash-2" /> remove icon next to your domain on the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page and confirm the removal. Existing links to the domain may break, and re-adding the domain may require reconfiguring your DNS records.
 
 Removing a domain also releases it so another Mintlify deployment or organization can claim it. If you cannot add a domain because another deployment holds it, see [Add domain fails with "Domain is already claimed by another organization"](/help-center/domain-already-claimed-by-another-organization).
 

diff --git a/deploy/bitbucket.mdx b/deploy/bitbucket.mdx
@@ -21,11 +21,11 @@ Mintlify supports Bitbucket Cloud repositories hosted on `bitbucket.org`. Bitbuc
 
 ## Set up a new Bitbucket connection
 
-When you open [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) for the first time, a setup wizard guides you through connecting your Bitbucket repository.
+When you open [Git Settings](https://app.mintlify.com/settings/project/git-settings) for the first time, a setup wizard guides you through connecting your Bitbucket repository.
 
 <Steps>
   <Step title="Select Bitbucket as your provider">
-    1. On the [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) page, click **Connect to Bitbucket**.
+    1. On the [Git Settings](https://app.mintlify.com/settings/project/git-settings) page, click **Connect to Bitbucket**.
     2. Click **Continue**.
   </Step>
   <Step title="Move Mintlify-hosted content">
@@ -59,7 +59,7 @@ When you open [Git Settings](https://app.mintlify.com/settings/deployment/git-se
 
 ## Update an existing connection
 
-1. Navigate to the [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) page of your Mintlify dashboard.
+1. Navigate to the [Git Settings](https://app.mintlify.com/settings/project/git-settings) page of your Mintlify dashboard.
 2. Expand the **Bitbucket OAuth** section.
 3. Enable or disable individual repositories. Disabling a repository removes its Mintlify webhook.
 

diff --git a/deploy/ci.mdx b/deploy/ci.mdx
@@ -16,7 +16,7 @@ To begin, follow the steps on the [GitHub](/deploy/github) page.
 
 ## Configuration
 
-Configure the CI checks enabled for a deployment by navigating to the [General](https://app.mintlify.com/settings/deployment/general) page of your dashboard. Enable the checks that you want to run.
+Configure the CI checks enabled for a deployment by navigating to the [General](https://app.mintlify.com/settings/project/general) page of your dashboard. Enable the checks that you want to run.
 
 When enabling checks, you can choose to run them at a `Warning` or `Blocking` level.
 

diff --git a/deploy/cloudflare.mdx b/deploy/cloudflare.mdx
@@ -50,7 +50,7 @@
 
 ### Configure routing
 
-In your Cloudflare dashboard, click **Edit Code** and add the script from your [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page, which has your values filled in, or copy the following example script. See the [Cloudflare documentation](https://developers.cloudflare.com/workers-ai/get-started/dashboard/#development) for more information on editing a Worker.
+In your Cloudflare dashboard, click **Edit Code** and add the script from your [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page, which has your values filled in, or copy the following example script. See the [Cloudflare documentation](https://developers.cloudflare.com/workers-ai/get-started/dashboard/#development) for more information on editing a Worker.
 
 <Tip>
   If you use the example script, replace `[SUBDOMAIN]` with your unique subdomain, `[YOUR_DOMAIN]` with your website's base URL, and `/docs` with your desired subpath if different.
@@ -107,7 +107,7 @@
 </Warning>

 <Note>
  The example script only proxies documentation traffic. If you add the Worker as a custom domain, requests outside your subpath, `/mintlify-assets/*`, `/_mintlify/*`, and `/.well-known/*` are not handled. If your main site is served on the same domain, either scope the Worker to the documentation paths with route patterns or route all other traffic to your main site as shown in [Webflow custom routing](#webflow-custom-routing).
 </Note>

 Click **Deploy** and wait for the changes to propagate.

diff --git a/deploy/docs-subpath.mdx b/deploy/docs-subpath.mdx
@@ -9,7 +9,7 @@ Host your documentation at a subpath like `your-domain.com/docs` to keep your do
 
 ## Let Mintlify manage your domain
 
-If your domain hosts nothing else, Mintlify can serve your documentation at your subpath without a proxy. In your dashboard, open the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page. Enable the **Host at** toggle, enter your base path, and add your domain. Then configure the DNS records shown in your dashboard to point your domain at Mintlify. See [Custom domain](/customize/custom-domain) for setup instructions.
+If your domain hosts nothing else, Mintlify can serve your documentation at your subpath without a proxy. In your dashboard, open the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page. Enable the **Host at** toggle, enter your base path, and add your domain. Then configure the DNS records shown in your dashboard to point your domain at Mintlify. See [Custom domain](/customize/custom-domain) for setup instructions.
 
 Only use this option if Mintlify can receive all paths on the domain.