mintlify · mintlify · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/editor/settings.mdx b/editor/settings.mdx
@@ -1,15 +1,38 @@
 ---
-title: "Editor settings for AI and publishing"
-description: "Configure AI instructions, pull request defaults, and the default merge method to control how the Mintlify web editor publishes changes."
+title: "Editor settings for appearance, AI, and publishing"
+description: "Configure appearance preferences, AI instructions, pull request defaults, and merge methods in the Mintlify web editor to manage editing and publishing."
 keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
 ---
 
-The web editor has two layers of settings:
+The web editor groups settings into four sections:
 
-- **Your settings** apply only to you and control how the editor's AI assists with your edits.
-- **Publishing settings** apply to everyone on a deployment and shape what happens when you commit changes and turn them into pull requests.
+- **Appearance** and **Chat** apply only to you.
+- **Publishing** applies to everyone on a deployment and controls what happens when you commit changes and turn them into pull requests.
+- **Danger zone** contains actions that can discard unpublished changes.
 
-You can configure both from the settings panel. To open it, click the <Icon icon="settings" /> settings icon in the editor toolbar.
+You can configure these settings from the settings panel. To open it, click the <Icon icon="settings" /> settings icon in the editor toolbar. The settings page displays all four sections.
-You can configure these settings from the settings panel. To open it, click the <Icon icon="settings" /> settings icon in the editor toolbar. The settings page displays all four sections.
+Click the <Icon icon="settings" /> settings icon in the editor toolbar to open the settings panel.
-You can configure these settings from the settings panel. To open it, click the <Icon icon="settings" /> settings icon in the editor toolbar. The settings page displays all four sections.
+Click the <Icon icon="settings" /> settings icon in the editor toolbar to open the settings panel.
+
+## Appearance
+
+Appearance settings control how the editor looks while you work. These preferences apply only to you.
+
+### Fit the editor to full width
+
+Enable **Fit editor to full width** when you need more horizontal space for wide content or source files. The editor stretches the editing canvas edge-to-edge instead of using the default 768px column.
+
+### Open live preview in a new tab
+
+Enable **Open live preview in new tab** when you want to keep the editor open while viewing the rendered page in a separate browser tab. When you preview your site, Mintlify opens the rendered page in a new tab.
+
+### Show all files
+
+Enable **Show all files** to display every file in the navigation sidebar, including files whose names begin with a period, code, and PDFs. You can also press <kbd>⌘⇧.</kbd> on macOS or <kbd>Ctrl+Shift+.</kbd> on other platforms to toggle this preference.
+
+To configure an appearance preference:
+
+1. Click the <Icon icon="settings" /> settings icon in the editor toolbar.
+2. Find or scroll to **Appearance**.
+3. Turn the preference on or off.
 
 ## AI instructions
 

diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
@@ -1,15 +1,54 @@
 ---
-title: "Configuración del editor para IA y publicación"
-description: "Configure instrucciones de IA, valores por defecto de pull requests y el método de fusión que usa el editor web de Mintlify al publicar cambios."
+title: "Configuración del editor para apariencia, IA y publicación"
+description: "Configure las preferencias de apariencia, las instrucciones de IA, los valores de pull request y los métodos de fusión del editor web de Mintlify."
 keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
 ---
 
-El editor web tiene dos capas de configuración:
+La configuración del editor se divide en cuatro secciones:
 
-- **Su configuración** se aplica solo a usted y controla cómo la IA del editor le ayuda con sus ediciones.
-- **La configuración de publicación** se aplica a todos en un deployment y determina qué sucede cuando confirma cambios y los convierte en pull requests.
+- **Apariencia** y **Chat** se aplican solo a usted.
+- **Publicación** se aplica a todos en un deployment y controla qué sucede cuando confirma cambios y los convierte en pull requests.
+- **Zona de peligro** contiene acciones que pueden descartar cambios sin publicar.
 
-Puede configurar ambas desde el panel de configuración. Para abrirlo, haga clic en el icono <Icon icon="settings" /> de configuración en la barra de herramientas del editor.
+Puede configurar estos ajustes desde el panel de configuración. Para abrirlo, haga clic en el icono <Icon icon="settings" /> de configuración en la barra de herramientas del editor. La página de configuración muestra las cuatro secciones.
+
+<div id="appearance">
+
+## Apariencia
+
+</div>
+
+La configuración de apariencia controla el aspecto del editor mientras trabaja. Estas preferencias solo se aplican a usted.
+
+<div id="fit-editor-to-full-width">
+
+### Ajustar el editor al ancho completo
+
+</div>
+
+Active **Fit editor to full width** cuando necesite más espacio horizontal para contenido o archivos fuente anchos. El editor extiende el lienzo de edición de un extremo al otro en lugar de usar la columna predeterminada de 768 px.
+
+<div id="open-live-preview-in-a-new-tab">
+
+### Abrir la vista previa en directo en una pestaña nueva
+
+</div>
+
+Active **Open live preview in new tab** cuando quiera mantener abierto el editor mientras ve la página renderizada en una pestaña independiente del navegador. Al obtener una vista previa del sitio, Mintlify abre la página renderizada en una pestaña nueva.
+
+<div id="show-all-files">
+
+### Mostrar todos los archivos
+
+</div>
+
+Active **Show all files** para mostrar los archivos que comienzan por un punto, los archivos de código, los archivos PDF y otros archivos ocultos de forma predeterminada. Mintlify los muestra en la barra lateral de navegación. También puede pulsar <kbd>⌘⇧.</kbd> en macOS o <kbd>Ctrl+Shift+.</kbd> en otras plataformas para alternar esta preferencia.
+
+Para configurar una preferencia de apariencia:
+
+1. Haga clic en el icono <Icon icon="settings" /> de configuración en la barra de herramientas del editor.
+2. Busque la sección **Appearance** o desplácese hasta ella.
+3. Active o desactive la preferencia.
 
 <div id="ai-instructions">
 

diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
@@ -25,6 +25,8 @@ Revisa tus analíticas de tráfico para:
 - **Identificar páginas populares**: Utiliza las páginas mejor clasificadas para comprender qué contenido es más importante para tus usuarios y así asegurarte de que esté actualizado y sea completo.
 - **Rastrear fuentes de referencia**: Comprende de dónde provienen tus usuarios para ayudarte a optimizar tu contenido para la audiencia adecuada.
 
+La tarjeta **Rankings** de la sección **Traffic** compara **Human views**, **Agent views**, **Referrals** y **Agent visitors**. Selecciona una métrica para clasificar páginas por vistas humanas o de agentes, revisar fuentes de referencia o identificar qué agentes acceden con más frecuencia a tu documentación.
+
 <Frame>
   <img
     src="/images/analytics/traffic-light.png"

diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
@@ -1,15 +1,54 @@
 ---
-title: "Paramètres de l'éditeur pour l'IA et la publication"
-description: "Configurez les instructions IA, les valeurs par défaut des pull requests et la méthode de fusion utilisée par l'éditeur web Mintlify pour publier."
+title: "Paramètres de l’éditeur : apparence, IA et publication"
+description: "Configurez les préférences d’apparence, les instructions IA, les valeurs par défaut des pull requests et les méthodes de fusion dans l’éditeur web Mintlify."
 keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
 ---
 
-L'éditeur web comporte deux niveaux de paramètres :
+Les paramètres de l'éditeur sont regroupés en quatre sections :
 
-- **Vos paramètres** ne s'appliquent qu'à vous et contrôlent la façon dont l'IA de l'éditeur vous assiste pendant vos modifications.
-- **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque vous validez des modifications et les transformez en pull requests.
+- **Apparence** et **Chat** s'appliquent uniquement à vous.
+- **Publication** s'applique à toutes les personnes d'un déploiement et contrôle ce qui se passe lorsque vous validez des modifications et les transformez en pull requests.
+- La **zone dangereuse** contient des actions qui peuvent supprimer des modifications non publiées.
 
-Vous pouvez configurer les deux depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres <Icon icon="settings" /> dans la barre d'outils de l'éditeur.
+Vous pouvez configurer ces paramètres depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres <Icon icon="settings" /> dans la barre d'outils de l'éditeur. La page des paramètres affiche les quatre sections.
+
+<div id="appearance">
+
+## Apparence
+
+</div>
+
+Les paramètres d'apparence contrôlent l'aspect de l'éditeur pendant votre travail. Ces préférences ne s'appliquent qu'à vous.
+
+<div id="fit-editor-to-full-width">
+
+### Adapter l'éditeur à toute la largeur
+
+</div>
+
+Activez **Fit editor to full width** lorsque vous avez besoin de plus d'espace horizontal pour des contenus ou des fichiers source larges. L'éditeur étend le canevas de modification sur toute la largeur au lieu d'utiliser la colonne par défaut de 768 px.
+
+<div id="open-live-preview-in-a-new-tab">
+
+### Ouvrir l'aperçu en direct dans un nouvel onglet
+
+</div>
+
+Activez **Open live preview in new tab** lorsque vous voulez garder l'éditeur ouvert tout en affichant la page rendue dans un onglet distinct du navigateur. Lorsque vous prévisualisez votre site, Mintlify ouvre la page rendue dans un nouvel onglet.
+
+<div id="show-all-files">
+
+### Afficher tous les fichiers
+
+</div>
+
+Activez **Show all files** pour afficher les fichiers commençant par un point, les fichiers de code, les PDF et les autres fichiers masqués par défaut. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur <kbd>⌘⇧.</kbd> sur macOS ou <kbd>Ctrl+Shift+.</kbd> sur les autres plateformes pour activer ou désactiver cette préférence.
+
+Pour configurer une préférence d'apparence :
+
+1. Cliquez sur l'icône de paramètres <Icon icon="settings" /> dans la barre d'outils de l'éditeur.
+2. Repérez la section **Appearance** ou faites défiler la page jusqu'à celle-ci.
+3. Activez ou désactivez la préférence.
 
 <div id="ai-instructions">
 

diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
@@ -25,6 +25,8 @@ Examinez vos analyses de trafic pour :
 - **Identifier les pages populaires** : utilisez les pages les mieux classées pour comprendre quels contenus sont les plus importants pour vos utilisateurs afin de vous assurer qu'ils restent à jour et complets.
 - **Suivre les sources de référence** : comprenez d'où viennent vos utilisateurs pour vous aider à optimiser votre contenu pour la bonne audience.
 
+La carte **Rankings** de la section **Traffic** compare **Human views**, **Agent views**, **Referrals** et **Agent visitors**. Sélectionnez un indicateur pour classer les pages selon les vues humaines ou d'agents, consulter les sources de référence ou identifier les agents qui accèdent le plus souvent à votre documentation.
+
 <Frame>
   <img
     src="/images/analytics/traffic-light.png"

diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
@@ -23,6 +23,8 @@ Review your traffic analytics to:
 - **Identify popular pages**: Use highly ranked pages to understand what content is most important to your users. Keep those pages up to date and comprehensive.
 - **Track referral sources**: Understand where your users are coming from to help you optimize your content for the right audience.
 
+The **Rankings** card in the Traffic section compares **Human views**, **Agent views**, **Referrals**, and **Agent visitors**. Select a metric to rank pages by human or agent views, review referral sources, or identify which agents access your documentation most often.
+
 <Frame>
   <img
     src="/images/analytics/traffic-light.png"

diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
@@ -1,15 +1,46 @@
 ---
-title: "用于 AI 与发布的编辑器设置"
-description: "配置 AI 指令、pull request 默认值以及默认合并方式，以控制 Mintlify Web 编辑器发布变更的方式。"
+title: "编辑器外观、AI 与发布设置"
+description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式。"
 keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
 ---
 
-Web 编辑器有两层设置：
+编辑器设置分为四个部分：
 
-- **个人设置**仅对你生效，控制编辑器的 AI 在你编辑时如何提供协助。
-- **发布设置**对部署中的所有人生效，决定变更在被提交并转换为 pull request 时如何处理。
+- **外观**和**聊天**仅对你生效。
+- **发布**对部署中的所有人都生效，并控制提交变更及将其转换为 pull request 时的处理方式。
+- **危险区域**包含可能丢弃未发布变更的操作。
 
-你可以在编辑器的 **Settings** 菜单中配置这两项。
+你可以在设置面板中配置这些选项。打开编辑器工具栏中的 <Icon icon="settings" /> 设置图标。设置页面会显示全部四个部分。
+
+<div id="appearance">
+  ## 外观
+</div>
+
+外观设置控制你工作时编辑器的显示方式。这些偏好仅对你生效。
+
+<div id="fit-editor-to-full-width">
+  ### 让编辑器适应全宽
+</div>
+
+当你需要更多水平空间来编辑宽内容或源文件时，启用 **Fit editor to full width**。编辑器会将编辑画布扩展到整个宽度，而不是使用默认的 768px 列宽。
+
+<div id="open-live-preview-in-a-new-tab">
+  ### 在新标签页中打开实时预览
+</div>
+
+当你希望保持编辑器打开，同时在独立的浏览器标签页中查看渲染后的页面时，启用 **Open live preview in new tab**。预览网站时，Mintlify 会在新标签页中打开渲染后的页面。
+
+<div id="show-all-files">
+  ### 显示所有文件
+</div>
+
+启用 **Show all files** 可显示点文件、代码、PDF 以及默认隐藏的其他文件。Mintlify 会在导航侧边栏中显示这些文件。你也可以在 macOS 上按 <kbd>⌘⇧.</kbd>，或在其他平台上按 <kbd>Ctrl+Shift+.</kbd> 来切换此偏好设置。
+
+配置外观偏好设置：
+
+1. 点击编辑器工具栏中的 <Icon icon="settings" /> 设置图标。
+2. 找到 **Appearance** 部分，或滚动到该部分。
+3. 打开或关闭偏好设置。
 
 <div id="ai-instructions">
   ## AI 指令
@@ -41,10 +72,9 @@ AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。
   ### 配置 AI 指令
 </div>
 
-1. 打开编辑器，点击工具栏中的头像。
-2. 选择 **Settings**。
-3. 在 **AI instructions** 字段中输入希望 AI 遵循的指令。
-4. 保存更改。
+1. 点击编辑器工具栏中的 <Icon icon="settings" /> 设置图标。
+2. 在 **AI instructions** 字段中输入希望 AI 遵循的指令。
+3. 保存更改。
 
 示例：
 

diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
@@ -25,6 +25,8 @@ boost: 3
 - **识别热门页面**:通过排名靠前的页面了解哪些内容对用户最重要,从而确保这些内容保持最新且完整全面。
 - **跟踪引荐来源**:了解用户来自何处,帮助您针对合适的受众优化内容。
 
+**Traffic** 部分的 **Rankings** 卡片可比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。选择指标可按人类或智能体浏览量对页面进行排名、查看引荐来源，或识别最常访问文档的智能体。
+
 <Frame>
   <img
     src="/images/analytics/traffic-light.png"