From f667d9fe5f5d33819fa151ab951dffb37fe82115 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 10 Sep 2026 19:14:33 +0000 Subject: [PATCH] docs: document selective publishing in the editor --- editor/publish.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/editor/publish.mdx b/editor/publish.mdx index 0017c25b1..55e0f13be 100644 --- a/editor/publish.mdx +++ b/editor/publish.mdx @@ -23,6 +23,18 @@ The editor tracks the following as pending changes: If there are no pending changes, the editor disables the publish and save actions. +## Publish selected changes + +By default, publishing includes every pending change on the branch. To publish only some of them, open the publish menu and select the changes you want to include. The editor publishes only the selected changes and keeps the rest as pending. + +Select up to 500 changes per publish. This applies to both **Publish** and **Create pull request**. + +Some pending changes depend on other pending changes to keep the navigation consistent. For example, a new page added to a new group can't publish without the group. When you select a change that depends on another, the editor automatically includes the changes it needs. If a dependency can't be resolved, the editor drops the selection instead of publishing an inconsistent navigation. + + + Selective publishing is available on request. Contact Mintlify to enable it for your deployment. + + ## What happens when you publish | Branch type | Branch protection | Available actions |