From 461944096a21be641b8e30c989ca4d828fc947bc Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 30 Oct 2026 10:14:37 +0000 Subject: [PATCH 1/3] docs: add October 30, 2026 changelog entry --- changelog.mdx | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index ed5295c978..f7174ffc6c 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,72 @@ rss: true noindex: true --- + + + ## Base + + - **Mintlify Base (beta):** A [base](/base/index) is a new project type for your team's internal knowledge, such as specs, runbooks, and onboarding guides. Your team and its agents update a base from the editor, the admin MCP, Slack, or Git. + - **Choose a project type:** When you create a project, choose **Docs** or **Base**. See [Create a project](/organize/projects#create-a-project). + - **Share base pages to the web:** Share a base page with people outside your organization through a public link that also serves a Markdown version for AI tools. See [Share a page to the web](/base/index#share-a-page-to-the-web). Available on Pro and Enterprise plans. + + ## Autopilot + + - **GitLab projects:** Autopilot works with docs repositories on GitLab and uses the GitLab projects you choose as context. See [GitLab projects](/autopilot#gitlab-projects). + - **Chat in Slack:** Mention `@mintlify` or message the Mintlify app to ask Autopilot questions or change its setup from Slack. See [Chat in Slack](/autopilot#chat-in-slack). + - **Pull request comments:** Comment on an Autopilot pull request on GitHub, and Autopilot pushes the requested changes to the same branch and replies in the thread. See [Review suggestions](/autopilot#review-suggestions). + + ## CLI + + - **`mint migrate`:** Print step-by-step instructions for moving from 21 documentation platforms, or pass `--agent` to have Claude Code, Codex, Cursor, or Gemini run the migration. See [`mint migrate`](/cli/commands#mint-migrate). + - **`mint instructions`:** Coding agents can look up how to do common Mintlify tasks, such as publishing a new site or adding a custom domain, instead of relying on their training data. See [`mint instructions`](/cli/commands#mint-instructions). + - **`mint agent setup`:** Install Mintlify skills and connect the admin MCP for Claude Code, Codex, or Cursor with one command. See [`mint agent setup`](/cli/commands#mint-agent-setup). + - **`mint validate` rules:** `mint validate` checks for content that builds but doesn't render correctly and lists each finding with its file, line, and rule. Repair common issues with `--fix`, choose rules with `--enable` and `--disable`, and get a JSON report with `--format json`. See [`mint validate`](/cli/commands#mint-validate). + - **Agent signup:** A coding agent can create and deploy a site with `mint deploy` before you have an account, including on every push from GitHub Actions. Claim the site with `mint claim`. See [Agent signup](/cli/agent-signup). + + ## Editor + + - **Switch repositories:** In a multi-repository project, pick a repository from the menu above your pages to edit its pages, files, and branches. See [Edit sources in the web editor](/deploy/multi-repo#edit-sources-in-the-web-editor). Available on Enterprise plans. + - **Unpublished changes in the sidebar:** Sidebar pages show an **Edited** or **Unpublished** badge until you publish them. Projects with auto publish don't show the badges. + - **Agent branches:** Ask the agent to list, create, or switch branches, and it reads, edits, and publishes on the branch it switched to. See [Work on other branches](/editor/agent#work-on-other-branches). + - **Components defined in a page:** Source mode autocompletes and describes components you define in the page, and jumps to their definitions with F12 or Cmd + click. See [Source mode shortcuts](/editor/keyboard-shortcuts#source-mode). + - **New pages at the top:** The **New page** button adds pages to the top of your navigation. See [Create a page](/editor/pages#create-a-page). + - **Move:** The page menu's **Move within project** option is now **Move**. See [Move a page](/editor/pages#move-a-page). + - **Copy tables:** Copy a table as CSV, JSON, Markdown, YAML, XML, or TOON from its block menu. + - **Auto publish timing:** With auto publish on, the editor commits about a minute after you stop editing. See [Auto publish](/editor/publish#auto-publish). + + ## AI and MCP + + - **Page history:** The admin MCP's `read_page_history` tool lists a page's saved versions and returns the content of any version. See [Content](/ai/mintlify-mcp#content). + - **Pages from uploaded files:** Upload a local Markdown file and pass its `uploadId` to `write_page` or `create_node` instead of sending the full page content. See [Uploads](/ai/mintlify-mcp#uploads). + - **Inbox:** The admin MCP's `read_inbox` tool lists comments, mentions, suggestions, and pages shared with you. See [Comments](/ai/mintlify-mcp#comments). + - **Mintlify skill:** The admin MCP's `read_skill` tool reads Mintlify's guide to writing docs, plus your organization's and your own agent skills. See [Mintlify skill](/ai/mintlify-mcp#mintlify-skill). + - **Projects with auto publish:** In projects with auto publish, the admin MCP commits edits to your deploy branch and doesn't create branches. See [Projects with auto publish](/ai/mintlify-mcp#projects-with-auto-publish). + + ## Published sites + + - **Emails authentication:** Invite readers outside your organization by email, and Mintlify hosts their sign-in with a password or a one-time code. See [Emails authentication](/deploy/emails-authentication). Available on Enterprise plans. + - **Navigate from custom scripts:** Call `window.mintlify.navigate` to send readers to another page without a full reload. See [Navigate to another page](/customize/custom-scripts#navigate-to-another-page). + - **Markdown block markers:** In `.md` pages, cards, accordions, and tabs open with `[card]`, `[accordion]`, and `[tab]` markers so AI tools can tell them apart. See [Components](/ai/markdown-export#components). + - **Go SDK references:** Go packages that mix kinds group their pages under Interfaces, Structs, Types, and Functions. Pass `-exclude-symbols` to the extractor to leave symbols out. See [Generated pages](/api-playground/sdk-reference-setup#generated-pages). + - **TypeDoc overview pages:** TypeDoc artifacts with a README get an overview page that indexes the library's symbols. See [Generated pages](/api-playground/sdk-reference-setup#generated-pages). + + ## Improvements + + - **Desktop app tabs:** Tabs signed in to different organizations work side by side. In the editor, Cmd + click or right-click a link to one of your pages to open that page in a new tab. + - **Thumbs-only feedback:** The feedback export API includes thumbs up and thumbs down votes submitted without a comment. See [Get feedback](/api/analytics/feedback). + - **Site settings:** The project **General** settings page is now called **Site**. + - **Deleted subdomains:** After you delete a project, Mintlify reserves its subdomain for your organization for 30 days. See [Delete a project](/deploy/deployments#delete-a-project). + + ## Bug fixes + + - **Editor:** Code blocks you type with three backticks in a list item stay in that list item. Cards render inside custom components in visual mode, table cell selections stay after you drag, and custom component previews load your fonts and repository CSS. Character references and hidden export blocks survive saves and deletions. The editor keeps syncing when browser storage stops accepting writes, and Cmd + J toggles the agent while you type in it. + - **Published sites:** Static files load on sites with authentication on custom domains. RSS feeds work on sites with authentication. Go references no longer repeat description sentences and render GitHub alerts as callouts. Sphinx references keep their module navigation and type links. The assistant follows the attachment settings in your `docs.json`. + - **CLI:** `mint validate` no longer crashes during connectivity checks. `mint dev` picks up snippet edits you made while it was stopped. MDX parse errors suggest escaping `<`. + - **Dashboard:** The sign-in page explains when your organization requires SSO. Parent page titles show after you refresh. + - **Desktop app:** Session refreshes no longer clear stored data or reload your tabs. + + + ## Autopilot From e28ba41cc5248c7ca59bd0be5380f72f68e700c4 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 30 Oct 2026 15:46:55 -0700 Subject: [PATCH 2/3] docs: correct and extend October 30 changelog entry Fix plan and gating claims (emails auth, public links), the mint migrate source count, read_inbox contents, block marker wording, and desktop right-click behavior. Add Autopilot on multi-repo sites, full-page search results, the admin MCP knowledge toolset and default project, the upload tool rename, JSX props in Markdown export, and the auth preview deletion default. Drop the unverifiable assistant attachments fix. Co-Authored-By: Claude Opus 5.5 --- changelog.mdx | 31 ++++++++++++++++++++----------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index f7174ffc6c..23366ced27 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -11,17 +11,18 @@ noindex: true - **Mintlify Base (beta):** A [base](/base/index) is a new project type for your team's internal knowledge, such as specs, runbooks, and onboarding guides. Your team and its agents update a base from the editor, the admin MCP, Slack, or Git. - **Choose a project type:** When you create a project, choose **Docs** or **Base**. See [Create a project](/organize/projects#create-a-project). - - **Share base pages to the web:** Share a base page with people outside your organization through a public link that also serves a Markdown version for AI tools. See [Share a page to the web](/base/index#share-a-page-to-the-web). Available on Pro and Enterprise plans. + - **Share base pages to the web:** After an admin turns on public links, share a base page with people outside your organization through a public link that also serves a Markdown version for AI tools. See [Share a page to the web](/base/index#share-a-page-to-the-web). Available on Pro and Enterprise plans. ## Autopilot - **GitLab projects:** Autopilot works with docs repositories on GitLab and uses the GitLab projects you choose as context. See [GitLab projects](/autopilot#gitlab-projects). - - **Chat in Slack:** Mention `@mintlify` or message the Mintlify app to ask Autopilot questions or change its setup from Slack. See [Chat in Slack](/autopilot#chat-in-slack). - - **Pull request comments:** Comment on an Autopilot pull request on GitHub, and Autopilot pushes the requested changes to the same branch and replies in the thread. See [Review suggestions](/autopilot#review-suggestions). + - **Chat in Slack:** Mention `@mintlify` or message the Mintlify app to ask Autopilot questions from Slack. Admins and editors can also change its setup. See [Chat in Slack](/autopilot#chat-in-slack). + - **Pull request comments:** Comment on an Autopilot pull request on GitHub, and Autopilot pushes the requested changes to the same branch and replies in the thread. See [Continue a conversation anywhere](/autopilot#continue-a-conversation-anywhere). + - **Multi-repository sites:** Autopilot works on docs sites built from [multiple repositories](/deploy/multi-repo). Available on Enterprise plans. ## CLI - - **`mint migrate`:** Print step-by-step instructions for moving from 21 documentation platforms, or pass `--agent` to have Claude Code, Codex, Cursor, or Gemini run the migration. See [`mint migrate`](/cli/commands#mint-migrate). + - **`mint migrate`:** Print step-by-step instructions for moving from 21 sources, such as Docusaurus, GitBook, ReadMe, Notion, and PDFs, or pass `--agent` to have Claude Code, Codex, Cursor, or Gemini run the migration. See [`mint migrate`](/cli/commands#mint-migrate). - **`mint instructions`:** Coding agents can look up how to do common Mintlify tasks, such as publishing a new site or adding a custom domain, instead of relying on their training data. See [`mint instructions`](/cli/commands#mint-instructions). - **`mint agent setup`:** Install Mintlify skills and connect the admin MCP for Claude Code, Codex, or Cursor with one command. See [`mint agent setup`](/cli/commands#mint-agent-setup). - **`mint validate` rules:** `mint validate` checks for content that builds but doesn't render correctly and lists each finding with its file, line, and rule. Repair common issues with `--fix`, choose rules with `--enable` and `--disable`, and get a JSON report with `--format json`. See [`mint validate`](/cli/commands#mint-validate). @@ -42,31 +43,39 @@ noindex: true - **Page history:** The admin MCP's `read_page_history` tool lists a page's saved versions and returns the content of any version. See [Content](/ai/mintlify-mcp#content). - **Pages from uploaded files:** Upload a local Markdown file and pass its `uploadId` to `write_page` or `create_node` instead of sending the full page content. See [Uploads](/ai/mintlify-mcp#uploads). - - **Inbox:** The admin MCP's `read_inbox` tool lists comments, mentions, suggestions, and pages shared with you. See [Comments](/ai/mintlify-mcp#comments). + - **Inbox:** The admin MCP's `read_inbox` tool lists comments, mentions, suggested edits, and invitations to your organization and to pages. See [Comments](/ai/mintlify-mcp#comments). - **Mintlify skill:** The admin MCP's `read_skill` tool reads Mintlify's guide to writing docs, plus your organization's and your own agent skills. See [Mintlify skill](/ai/mintlify-mcp#mintlify-skill). + - **Read-only connections:** Send the `x-mintlify-toolset: knowledge` header to limit an admin MCP connection to search and read tools. See [Limit a connection to search and read tools](/ai/mintlify-mcp#limit-a-connection-to-search-and-read-tools). + - **Default project:** On a connection with access to a single project, read tools no longer need a `subdomain`. See [How editing works](/ai/mintlify-mcp#how-editing-works). - **Projects with auto publish:** In projects with auto publish, the admin MCP commits edits to your deploy branch and doesn't create branches. See [Projects with auto publish](/ai/mintlify-mcp#projects-with-auto-publish). + ### Breaking change + + - **Admin MCP upload tools renamed:** `upload_image` is now `upload_file`, and `finalize_image_upload` is now `finalize_file_upload`. Update prompts or scripts that call the old names. See [Uploads](/ai/mintlify-mcp#uploads). + ## Published sites - - **Emails authentication:** Invite readers outside your organization by email, and Mintlify hosts their sign-in with a password or a one-time code. See [Emails authentication](/deploy/emails-authentication). Available on Enterprise plans. + - **Emails authentication:** Invite readers outside your organization by email, and Mintlify hosts their sign-in with a password or a one-time code. See [Emails authentication](/deploy/emails-authentication). Contact sales to turn it on for your site. + - **Full-page search results:** Turn on **Full-page search results** in your [Site](https://app.mintlify.com/settings/project/site) settings to give readers a search results page at `/search` that they can bookmark and share. See [Full-page search results](/optimize/search#full-page-search-results). - **Navigate from custom scripts:** Call `window.mintlify.navigate` to send readers to another page without a full reload. See [Navigate to another page](/customize/custom-scripts#navigate-to-another-page). - - **Markdown block markers:** In `.md` pages, cards, accordions, and tabs open with `[card]`, `[accordion]`, and `[tab]` markers so AI tools can tell them apart. See [Components](/ai/markdown-export#components). + - **Markdown export:** In `.md` pages, cards, accordions, and tabs render as blockquotes that open with `[card]`, `[accordion]`, or `[tab]`, so AI tools can tell them apart. Props written as JSX, such as a `Tooltip`'s `tip`, render as Markdown. See [Components](/ai/markdown-export#components). - **Go SDK references:** Go packages that mix kinds group their pages under Interfaces, Structs, Types, and Functions. Pass `-exclude-symbols` to the extractor to leave symbols out. See [Generated pages](/api-playground/sdk-reference-setup#generated-pages). - **TypeDoc overview pages:** TypeDoc artifacts with a README get an overview page that indexes the library's symbols. See [Generated pages](/api-playground/sdk-reference-setup#generated-pages). ## Improvements - - **Desktop app tabs:** Tabs signed in to different organizations work side by side. In the editor, Cmd + click or right-click a link to one of your pages to open that page in a new tab. + - **Desktop app tabs:** Tabs signed in to different organizations work side by side. In the editor, Cmd + click a link to one of your pages to open that page in a new tab, or right-click it to open it in a new tab or window. - **Thumbs-only feedback:** The feedback export API includes thumbs up and thumbs down votes submitted without a comment. See [Get feedback](/api/analytics/feedback). - **Site settings:** The project **General** settings page is now called **Site**. + - **Previews when you turn on authentication:** Turning on authentication through the API or admin MCP deletes previews that don't have authentication, matching the dashboard. To keep them, pass `previewDeployments: "keep"`. - **Deleted subdomains:** After you delete a project, Mintlify reserves its subdomain for your organization for 30 days. See [Delete a project](/deploy/deployments#delete-a-project). ## Bug fixes - - **Editor:** Code blocks you type with three backticks in a list item stay in that list item. Cards render inside custom components in visual mode, table cell selections stay after you drag, and custom component previews load your fonts and repository CSS. Character references and hidden export blocks survive saves and deletions. The editor keeps syncing when browser storage stops accepting writes, and Cmd + J toggles the agent while you type in it. - - **Published sites:** Static files load on sites with authentication on custom domains. RSS feeds work on sites with authentication. Go references no longer repeat description sentences and render GitHub alerts as callouts. Sphinx references keep their module navigation and type links. The assistant follows the attachment settings in your `docs.json`. + - **Editor:** Code blocks you type with three backticks in a list item stay in that list item. Cards render inside custom components in visual mode, table cell selections stay after you drag, and custom component previews load your fonts and repository CSS. Character references and hidden export blocks survive saves and deletions. Parent page titles show in the sidebar after you refresh. The editor keeps syncing when browser storage stops accepting writes, and Cmd + J toggles the agent while you type in it. + - **Published sites:** Static files load on sites with authentication on custom domains. RSS feeds work on sites with authentication. Go references no longer repeat description sentences and render GitHub alerts as callouts. Sphinx references keep their module navigation and type links. - **CLI:** `mint validate` no longer crashes during connectivity checks. `mint dev` picks up snippet edits you made while it was stopped. MDX parse errors suggest escaping `<`. - - **Dashboard:** The sign-in page explains when your organization requires SSO. Parent page titles show after you refresh. + - **Dashboard:** The sign-in page explains when your organization requires SSO. - **Desktop app:** Session refreshes no longer clear stored data or reload your tabs. From b7f071b7552e5d96c3416b1f6465c3807914f5b3 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 30 Oct 2026 16:18:43 -0700 Subject: [PATCH 3/3] Update changelog.mdx --- changelog.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index 23366ced27..fcf9793925 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -10,19 +10,18 @@ noindex: true ## Base - **Mintlify Base (beta):** A [base](/base/index) is a new project type for your team's internal knowledge, such as specs, runbooks, and onboarding guides. Your team and its agents update a base from the editor, the admin MCP, Slack, or Git. - - **Choose a project type:** When you create a project, choose **Docs** or **Base**. See [Create a project](/organize/projects#create-a-project). - **Share base pages to the web:** After an admin turns on public links, share a base page with people outside your organization through a public link that also serves a Markdown version for AI tools. See [Share a page to the web](/base/index#share-a-page-to-the-web). Available on Pro and Enterprise plans. ## Autopilot - - **GitLab projects:** Autopilot works with docs repositories on GitLab and uses the GitLab projects you choose as context. See [GitLab projects](/autopilot#gitlab-projects). + - **GitLab projects:** Autopilot works with repositories on GitLab and uses the GitLab projects you choose as context. See [GitLab projects](/autopilot#gitlab-projects). - **Chat in Slack:** Mention `@mintlify` or message the Mintlify app to ask Autopilot questions from Slack. Admins and editors can also change its setup. See [Chat in Slack](/autopilot#chat-in-slack). - **Pull request comments:** Comment on an Autopilot pull request on GitHub, and Autopilot pushes the requested changes to the same branch and replies in the thread. See [Continue a conversation anywhere](/autopilot#continue-a-conversation-anywhere). - **Multi-repository sites:** Autopilot works on docs sites built from [multiple repositories](/deploy/multi-repo). Available on Enterprise plans. ## CLI - - **`mint migrate`:** Print step-by-step instructions for moving from 21 sources, such as Docusaurus, GitBook, ReadMe, Notion, and PDFs, or pass `--agent` to have Claude Code, Codex, Cursor, or Gemini run the migration. See [`mint migrate`](/cli/commands#mint-migrate). + - **`mint migrate`:** Print step-by-step instructions for migrating content to Mintlify from 21 sources, such as Docusaurus, GitBook, ReadMe, Notion, and PDFs. Pass the `--agent` flag to have Claude Code, Codex, Cursor, or Gemini run the migration. See [`mint migrate`](/cli/commands#mint-migrate). - **`mint instructions`:** Coding agents can look up how to do common Mintlify tasks, such as publishing a new site or adding a custom domain, instead of relying on their training data. See [`mint instructions`](/cli/commands#mint-instructions). - **`mint agent setup`:** Install Mintlify skills and connect the admin MCP for Claude Code, Codex, or Cursor with one command. See [`mint agent setup`](/cli/commands#mint-agent-setup). - **`mint validate` rules:** `mint validate` checks for content that builds but doesn't render correctly and lists each finding with its file, line, and rule. Repair common issues with `--fix`, choose rules with `--enable` and `--disable`, and get a JSON report with `--format json`. See [`mint validate`](/cli/commands#mint-validate).