Update from code changes: document selective publishing setting

[mintlify]

Summary

Documents the new Selective publishing editor setting that lets admins enable per-change checkboxes when publishing directly to the deployment branch, and the safety guarantee that incomplete selections are rejected before any commit.

Changes

• Added a "Selective publishing" section to the editor settings page: what the setting does, that it's off by default, that it applies only on an unprotected deployment branch, and that dependent changes (like a deleted page and its navigation entry) toggle together.
• Noted that Mintlify rejects a publish before creating a commit if the selection leaves out a change that selected changes depend on.
• Added a one-line mention with a link on the publish page's Publish action.
• Mirrored all changes in the Spanish, French, and Chinese translations.

Context

The web editor now toggles each pending change independently in the publish flow instead of grouping all configuration changes together, and adds a deployment-wide "Selective publishing" setting (persisted, default off) that gates the per-row checkboxes. Removal-related rows still select and deselect as a group so partial publishes stay consistent. The settings toggle ships unconditionally, but the per-row checkboxes in the publish flow are additionally gated behind a remote feature flag (scoped-publishing), so confirm rollout state before merging.

The backend now validates explicit publish selections strictly: if a selection would require unselected dependencies or would drop requested actions, the publish aborts before any commit is created instead of silently expanding or trimming the selection.

https://github.com/mintlify/mint/pull/10658

Update history

• Documented the Selective publishing setting and publish-page mention, with es/fr/zh translations (https://github.com/mintlify/mint/pull/10658).
• Added the pre-commit rejection guarantee for selections missing dependent changes, with es/fr/zh translations (https://github.com/mintlify/server/pull/8372).

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Sep 21, 2026, 11:49 PM

[mintlify]

Update from code changes updated this PR.

Added note that incomplete selective publish selections are rejected before committing

Source PRs

• mintlify/server#8372 — Allow direct file selection and reject unselected dependencies

[ethanpalm]

Superseded by #7450