|
| 1 | +--- |
| 2 | +title: List of Hidden/Advanced Preferences |
| 3 | +description: A list of useful flags in Zen Browser's Advanced Preferences page (about:config). |
| 4 | +--- |
| 5 | +These are a variety of settings that can change Zen's appearance, behavior, and more. To access them, go to `about:config` in Zen Browser, and search for the title of the flag. Some of these flags may require a restart to work. |
| 6 | + |
| 7 | +### Appearance |
| 8 | +#### `zen.theme.content-element-separation` |
| 9 | +Changes the size of the border around the browser window. 8 by default. |
| 10 | +#### `zen.theme.accent-color` |
| 11 | +The color hex value of Zen's main accent color. |
| 12 | +#### `zen.theme.essentials-favicon-bg` |
| 13 | +Enables a colorful icon for when an essential tab is selected, based on the website's favicon. Enabled by default. |
| 14 | +#### `zen.theme.gradient` |
| 15 | +Allows setting custom sidebar colors. Enabled by default. |
| 16 | +#### `zen.theme.gradient.show-custom-colors` |
| 17 | +Allows setting a color hex as your sidebar color. Disabled by default. |
| 18 | +#### `zen.view.experimental-rounded-view` |
| 19 | +??? Disabled by default. |
| 20 | +#### `zen.view.gray-out-inactive-windows` |
| 21 | +If a window is inactive, the theme color fades to gray. Enabled by default. |
| 22 | +#### `zen.watermark.enabled` |
| 23 | +Shows a splash screen briefly when Zen is opened. Enabled by default. |
| 24 | + |
| 25 | +### Transparency & Blur |
| 26 | +#### `zen.theme.acrylic-elements` |
| 27 | +Windows-specific. Allows use of Windows' Acrylic protocol for a blur effect in Zen. Enabled by default on Windows. |
| 28 | +#### `zen.widget.linux.transparency` |
| 29 | +Linux-specific. Makes the browser UI transparent. |
| 30 | +#### `browser.tabs.allow_transparent_browser` |
| 31 | +Changes the default website background to your theme color. Disabled by default. |
| 32 | +<Callout type="warn"> |
| 33 | +Enabling could break the way certain websites look. |
| 34 | +</Callout> |
| 35 | + |
| 36 | +### Tabs |
| 37 | +#### `zen.tab-unloader.excluded-urls` |
| 38 | +A comma-separated list of URLs exempt from being unloaded. |
| 39 | +#### `zen.tabs.dim-pending` |
| 40 | +Dims unloaded tabs. Enabled by default. |
| 41 | +#### `zen.tabs.rename-tabs` |
| 42 | +Allows renaming pinned tabs. Enabled by default. |
| 43 | +#### `zen.ctrlTab.show-pending-tabs` |
| 44 | +Allow switching to unloaded tabs using Ctrl+Tab, when "Ctrl+Tab cycles through tabs in recently used order" is enabled. Disabled by default. |
| 45 | +#### `zen.startup.smooth-scroll-in-tabs` |
| 46 | +Turns on smooth scrolling when scrolling through tabs. Enabled by default. |
| 47 | +#### `toolkit.tabbox.switchByScrolling` |
| 48 | +Allows to switch tabs by scrolling when hovering over tabs. Disabled by default. |
| 49 | + |
| 50 | +### New Tabs |
| 51 | +#### `zen.urlbar.replace-newtab` |
| 52 | +Replaces opening a new tab, with instead showing the URL bar and allowing you to input a query which will then open a new tab. Enabled by default. |
| 53 | +#### `zen.workspaces.open-new-tab-if-last-unpinned-tab-is-closed` |
| 54 | +Opens a new tab when all pinned tabs are unloaded, and all tabs are closed. Disabled by default. |
| 55 | + |
| 56 | +### URL Bar |
| 57 | +#### `zen.urlbar.hide-one-offs` |
| 58 | +Hides the alternative search engines from appearing in the URL bar. Enabled by default. |
| 59 | +#### `zen.urlbar.show-domain-only-in-sidebar` |
| 60 | +When Single Toolbar is enabled, shows only the website domain(ex: example.com) instead of the full URL(ex: example.com\/page). Enabled by default. |
| 61 | +#### `zen.urlbar.show-protections-icon` |
| 62 | +Shows the "protections" icon in the URL bar, which details security information about the current website. Disabled by default. |
| 63 | +#### `zen.urlbar.wait-to-clear` |
| 64 | +How long the URL bar saves what you typed, if you typed something in and unfocused it in milliseconds. 45000 by default. |
| 65 | + |
| 66 | +### Sidebar |
| 67 | +#### `zen.view.sidebar-collapsed.hide-mute-button` |
| 68 | +Hides the mute button in Collapsed Toolbar mode. |
| 69 | +#### `zen.view.sidebar-expanded.max-width` |
| 70 | +Controls the width of the sidebar in Single Toolbar or Multiple Toolbars mode. |
| 71 | +#### `zen.view.sidebar-height-throttle` |
| 72 | +??? 200 by default. |
| 73 | + |
| 74 | +### Window Controls |
| 75 | +#### `zen.view.hide-window-controls` |
| 76 | +Hides the window controls. Enabled by default. |
| 77 | +<Callout> |
| 78 | +In Single Toolbar mode, this hides the toolbar, which can then be revealed on hover. |
| 79 | +</Callout> |
| 80 | +#### `zen.view.experimental-force-window-controls-left` |
| 81 | +Forces the window controls to appear on the left side of the window. Disabled by default. |
| 82 | +<Callout> |
| 83 | +If the sidebar is in the left side, it will appear in it. |
| 84 | +</Callout> |
| 85 | +#### `zen.view.experimental-no-window-controls` |
| 86 | +Removes the window controls entirely. Disabled by default. |
| 87 | +<Callout> |
| 88 | +This will disable the toolbar in Single Toolbar mode. |
| 89 | +</Callout> |
| 90 | + |
| 91 | +### Workspaces |
| 92 | +#### `zen.workspaces.swipe-actions` |
| 93 | +Allows swiping with the trackpad on the sidebar to switch workspaces. Enabled by default. |
| 94 | +#### `zen.workspaces.wrap-around-navigation` |
| 95 | +When swiping through tabs, allow going to the last workspace from the first workspace by swiping left, or vice versa. Enabled by default. |
| 96 | +#### `zen.workspaces.natural-scroll` |
| 97 | +Turns on natural scrolling for swiping through workspaces. Disabled by default. |
| 98 | +#### `zen.workspaces.scroll-modifier-key` |
| 99 | +Controls the hotkey that enables hovering over the sidebar and switching workspaces by scrolling. Options are 'ctrl', 'alt', 'shift'. Default is 'ctrl'. |
| 100 | + |
| 101 | +### Compact mode |
| 102 | +#### `zen.view.compact.animate-sidebar` |
| 103 | +Animates the webpage moving in/out when compact mode is enabled/disabled. Enabled by default. |
| 104 | +#### `zen.view.compact.color-sidebar` |
| 105 | +Colors the sidebar with your custom theme color during compact mode. Enabled by default. |
| 106 | +#### `zen.view.compact.color-toolbar` |
| 107 | +Colors the toolbar with your custom theme color during compact mode. Enabled by default. |
| 108 | +#### `zen.view.show-background-tab-toast` |
| 109 | +Shows a toast when a tab is open while compact mode is enabled. Enabled by default. |
| 110 | +#### `zen.view.compact.show-sidebar-and-toolbar-on-hover` |
| 111 | +Shows the sidebar/toolbar if you hover in their general area during compact mode. Enabled by default. |
| 112 | +#### `zen.view.compact.toolbar-flash-popup` |
| 113 | +Shows the sidebar for a moment when opening a new tab during compact mode. Disabled by default. |
| 114 | +<Callout type="info"> |
| 115 | +`zen.view.compact.toolbar-flash-popup.duration` controls the duration in milliseconds. 800 by default. |
| 116 | +</Callout> |
| 117 | +#### `zen.view.compact.toolbar-hide-after-hover.duration` |
| 118 | +Controls the duration until which the toolbar/sidebar hides after you stopped hovering over it in compact mode. 1000 by default. |
| 119 | + |
| 120 | +### Split View |
| 121 | +#### `zen.splitView.enable-tab-drop` |
| 122 | +When enabled, dropping a tab from the sidebar to the current webpage starts split view. Enabled by default. |
| 123 | +#### `zen.splitView.min-resize-width` |
| 124 | +The minimum width or height of any split view tab. The number represents the percentage of the screen taken up by the tab. 7 by default. |
| 125 | +#### `zen.splitView.rearrange-hover-size` |
| 126 | +??? 24 by default. |
| 127 | + |
| 128 | +### Media |
| 129 | +#### `zen.mediacontrols.enabled` |
| 130 | +Shows a media player interface if audio is playing in another tab, or a conference call interface if you're in a conference call. Enabled by default. |
| 131 | +#### `media.videocontrols.picture-in-picture.enabled` |
| 132 | +Allows picture-in-picture. Enabled by default. |
| 133 | +#### `media.videocontrols.picture-in-picture.enable-when-switching-tabs.enabled` |
| 134 | +Automatically turns on picture-in-picture when switching tabs during video playback. Disabled by default. |
| 135 | + |
| 136 | +### Other |
| 137 | +#### `zen.keyboard.shortcuts.enabled` |
| 138 | +Allows changing keyboard shortcuts. Enabled by default. |
| 139 | +#### `zen.glance.open-essential-external-links` |
| 140 | +When enabled, external links that are opened inside an essential tab will open in Glance. Enabled by default. |
| 141 | +#### `browser.toolbars.bookmarks.visibility` |
| 142 | +Controls when the bookmarks toolbar is shown. Options are 'always', 'newtab', 'never'. Default is 'never'. |
| 143 | +#### `zen.downloads.download-animation` |
| 144 | +When enabled, plays an animation when a download begins. Enabled by default. |
| 145 | +<Callout type="info"> |
| 146 | +`zen.downloads.download-animation-duration` controls the duration in miliseconds. 1000 by default. |
| 147 | +</Callout> |
| 148 | +#### `zen.haptic-feedback.enabled` |
| 149 | +macOS-specific. Triggers haptic feedback on the trackpad's vibration motor when you drag tabs around, or change the texture in the Change Theme Colors pop-up. Enabled by default. |
| 150 | +#### `zen.browser.is-cool` |
| 151 | +This is true. |
0 commit comments