mintlify · mintlify · Sep 9, 2026
diff --git a/editor/publish.mdx b/editor/publish.mdx
@@ -32,7 +32,7 @@
 | <Tooltip tip="An isolated branch where you work on updates before merging to your deployment branch." headline="Feature branch">Feature branch</Tooltip> | None | **Save in branch**, **Create pull request** |
 | Feature branch | Pull requests required | **Save in branch**, **Create pull request** |
 
-- **Publish**: Commits and deploys your changes to your live site immediately.
+- **Publish**: Commits and deploys your changes to your live site immediately. With [selective publishing](/editor/settings#selective-publishing) turned on, you choose which pending changes to include.
 - **Save in branch**: Commits your changes to the feature branch without merging to your deployment branch.
 - **Create branch**: Moves your pending changes to a new feature branch when you're on a protected deployment branch.
 - **Create pull request**: Opens a pull request targeting your deployment branch.
@@ -73,6 +73,6 @@

 ## Auto publish

 If your deployment has [auto publish](/editor/settings#main-branch-autocommits) turned on, the editor commits to your deployment branch shortly after you stop typing. The branch selector and **Publish** button are hidden. There is no pending state and no review step.

 Edits on feature branches created from the editor commit automatically either way, but they never publish unless you merge them into your deployment branch.
diff --git a/editor/settings.mdx b/editor/settings.mdx
@@ -40,7 +40,7 @@
 using its relative path.
 ```

 Instructions are limited to 20,000 characters.

 ## Main branch autocommits

@@ -56,6 +56,12 @@
 
 If you want editor pull requests to open ready for review immediately, turn off draft pull requests.
 
+## Selective publishing
+
+Selective publishing lets you choose which pending changes to include when you publish directly to your deployment branch. When this setting is on, the publish flow shows a checkbox next to each pending change. Deselect any changes you want to hold back. Deselected changes stay pending so you can publish them later. This setting is off by default.
+
+Selective publishing applies only when you publish directly on a deployment branch without branch protections. Changes that depend on each other select and deselect together. For example, deleting a page removes both the page file and its navigation entry as one selection.
+
 ## PR merge method
 
 Choose how the editor merges pull requests when you click **Merge and publish**:
@@ -79,7 +85,7 @@
 - **Edit with AI** actions on a selection, such as rewrite, expand, or fix.
 - **Agent sessions** started from the editor.

 Each teammate maintains their own instructions, scoped to their user account. Instructions are limited to 20,000 characters.

 Add AI instructions when you find yourself repeating the same guidance in prompts, for example:


diff --git a/es/editor/publish.mdx b/es/editor/publish.mdx
@@ -40,7 +40,7 @@ Si no hay cambios pendientes, el editor deshabilita las acciones de publicar y g
 | <Tooltip tip="Una branch aislada donde trabaja en actualizaciones antes de hacer merge en su deployment branch." headline="Feature branch">Feature branch</Tooltip> | Ninguna | **Save in branch**, **Create pull request** |
 | Feature branch | Requiere pull requests | **Save in branch**, **Create pull request** |
 
-- **Publish**: Hace commit y despliega sus cambios en su sitio publicado de inmediato.
+- **Publish**: Hace commit y despliega sus cambios en su sitio publicado de inmediato. Con la [publicación selectiva](/es/editor/settings#selective-publishing) activada, usted elige qué cambios pendientes incluir.
 - **Save in branch**: Hace commit de sus cambios en la feature branch sin hacer merge en su deployment branch.
 - **Create branch**: Mueve sus cambios pendientes a una feature branch nueva cuando está en una deployment branch protegida.
 - **Create pull request**: Abre una pull request dirigida a su deployment branch.

diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
@@ -72,6 +72,16 @@ Cuando este ajuste está activado, las pull requests creadas desde el editor se
 
 Desactívelo si quiere que las pull requests del editor se abran listas para revisión de inmediato.
 
+<div id="selective-publishing">
+
+## Publicación selectiva
+
+</div>
+
+La publicación selectiva le permite elegir qué cambios pendientes incluir cuando publica directamente en su deployment branch. Cuando este ajuste está activado, el flujo de publicación muestra una casilla junto a cada cambio pendiente. Desmarque los cambios que quiera retener. Los cambios desmarcados permanecen pendientes para que pueda publicarlos más tarde. Este ajuste está desactivado de forma predeterminada.
+
+La publicación selectiva solo se aplica cuando publica directamente en una deployment branch sin protecciones de branch. Los cambios que dependen entre sí se seleccionan y deseleccionan juntos. Por ejemplo, eliminar una página quita tanto el archivo de la página como su entrada de navegación en una sola selección.
+
 <div id="pr-merge-method">
 
 ## Método de merge de PR

diff --git a/fr/editor/publish.mdx b/fr/editor/publish.mdx
@@ -40,7 +40,7 @@ S'il n'y a aucune modification en attente, l'éditeur désactive les actions de
 | <Tooltip tip="Une branch isolée sur laquelle vous travaillez avant de fusionner dans votre deployment branch." headline="Feature branch">Feature branch</Tooltip> | Aucune | **Save in branch**, **Create pull request** |
 | Feature branch | Pull requests requises | **Save in branch**, **Create pull request** |
 
-- **Publish** : Commit et déploie vos modifications vers votre site publié immédiatement.
+- **Publish** : Commit et déploie vos modifications vers votre site publié immédiatement. Avec la [publication sélective](/fr/editor/settings#selective-publishing) activée, vous choisissez quelles modifications en attente inclure.
 - **Save in branch** : Commit vos modifications sur la feature branch sans fusionner dans votre deployment branch.
 - **Create branch** : Déplace vos modifications en attente vers une nouvelle feature branch lorsque vous êtes sur une deployment branch protégée.
 - **Create pull request** : Ouvre une pull request vers votre deployment branch.

diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
@@ -72,6 +72,16 @@ Lorsque ce paramètre est activé, les pull requests créées depuis l'éditeur
 
 Désactivez-le si vous voulez que les pull requests de l'éditeur s'ouvrent immédiatement prêtes à être relues.
 
+<div id="selective-publishing">
+
+## Publication sélective
+
+</div>
+
+La publication sélective vous permet de choisir quelles modifications en attente inclure lorsque vous publiez directement sur votre deployment branch. Lorsque ce paramètre est activé, le flux de publication affiche une case à cocher à côté de chaque modification en attente. Décochez les modifications que vous souhaitez retenir. Les modifications décochées restent en attente pour que vous puissiez les publier plus tard. Ce paramètre est désactivé par défaut.
+
+La publication sélective s'applique uniquement lorsque vous publiez directement sur une deployment branch sans protections de branch. Les modifications qui dépendent les unes des autres se sélectionnent et se désélectionnent ensemble. Par exemple, supprimer une page retire à la fois le fichier de la page et son entrée de navigation en une seule sélection.
+
 <div id="pr-merge-method">
 
 ## Méthode de fusion des PR

diff --git a/zh/editor/publish.mdx b/zh/editor/publish.mdx
@@ -40,7 +40,7 @@ keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull re
 | <Tooltip tip="在合并到 deployment branch 之前，用于进行更新的独立分支。" headline="Feature branch">Feature branch</Tooltip> | 无 | **Save in branch**、**Create pull request** |
 | Feature branch | 要求 pull request | **Save in branch**、**Create pull request** |
 
-- **Publish**：立即提交并把更改部署到已发布的站点。
+- **Publish**：立即提交并把更改部署到已发布的站点。启用[选择性发布](/zh/editor/settings#selective-publishing)后，你可以选择要包含哪些待处理更改。
 - **Save in branch**：把更改提交到 feature branch，但不合并到 deployment branch。
 - **Create branch**：当你位于受保护的 deployment branch 上时，把待处理更改移动到新的 feature branch。
 - **Create pull request**：打开一个以 deployment branch 为目标的 pull request。

diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
@@ -72,6 +72,16 @@ main 分支自动提交会在你停止输入后不久，自动把更改推送到
 
 如果你希望从编辑器创建的 pull request 一打开就处于可供审阅状态，请关闭该设置。
 
+<div id="selective-publishing">
+
+## 选择性发布
+
+</div>
+
+选择性发布让你在直接发布到 deployment branch 时选择要包含哪些待处理更改。启用该设置后，发布流程会在每个待处理更改旁边显示复选框。取消勾选你想暂缓的更改。取消勾选的更改会保持待处理状态，你可以稍后再发布。该设置默认关闭。
+
+选择性发布仅在你直接在没有分支保护的 deployment branch 上发布时生效。相互依赖的更改会一起选中和取消选中。例如，删除页面会在同一个选择中同时移除页面文件及其导航条目。
+
 <div id="pr-merge-method">
 
 ## PR 合并方式