# Settings

Table 1. Quick reference for section “general”
Setting | Description
--- | ---
ignore-case | Whether to find text on a page case-insensitively.
startpage | The default page(s) to open at the start, separated by commas.
yank-ignored-url-parameters | The URL parameters to strip with :yank url, separated by commas.
default-open-dispatcher | The default program used to open downloads. Set to an empty string to use the default internal handler.
default-page | The page to open if :open -t/-b/-w is used without URL. Use `about:blank` for a blank page.
auto-search | Whether to start a search when something else than a URL is entered.
auto-save-config | Whether to save the config automatically on quit.
auto-save-interval | How often (in milliseconds) to auto-save config/cookies/etc.
editor | The editor (and arguments) to use for the `open-editor` command.
editor-encoding | Encoding to use for editor.
private-browsing | Do not record visited pages in the history or store web page icons.
developer-extras | Enable extra tools for Web developers.
print-element-backgrounds | Whether the background color and images are also drawn when the page is printed.
xss-auditing | Whether load requests should be monitored for cross-site scripting attempts.
site-specific-quirks | Enable QtWebKit workarounds for broken sites.
default-encoding | Default encoding to use for websites.
new-instance-open-target | How to open links in an existing instance if a new one is launched.
new-instance-open-target.window | Which window to choose when opening links as new tabs.
log-javascript-console | How to log javascript console messages.
save-session | Whether to always save the open pages.
session-default-name | The name of the session to save by default, or empty for the last loaded session.
url-incdec-segments | The URL segments where `:navigate increment/decrement` will search for a number.

Table 2. Quick reference for section “ui”
Setting | Description
--- | ---
zoom-levels | The available zoom levels, separated by commas.
default-zoom | The default zoom level.
downloads-position | Where to show the downloaded files.
status-position | The position of the status bar.
message-timeout | Time (in ms) to show messages in the statusbar for.
message-unfocused | Whether to show messages in unfocused windows.
confirm-quit | Whether to confirm quitting the application.
zoom-text-only | Whether the zoom factor on a frame applies only to the text or to all content.
frame-flattening | Whether to expand each subframe to its contents.
user-stylesheet | User stylesheet to use (absolute filename or filename relative to the config directory). Will expand environment variables.
hide-scrollbar | Hide the main scrollbar.
css-media-type | Set the CSS media type.
smooth-scrolling | Whether to enable smooth scrolling for webpages.
remove-finished-downloads | Number of milliseconds to wait before removing finished downloads. Will not be removed if value is -1.
hide-statusbar | Whether to hide the statusbar unless a message is shown.
statusbar-padding | Padding for statusbar (top, bottom, left, right).
window-title-format | The format to use for the window title. The following placeholders are defined:
modal-js-dialog | Use standard JavaScript modal dialog for alert() and confirm()
hide-wayland-decoration | Hide the window decoration when using wayland (requires restart)
keyhint-blacklist | Keychains that shouldn’t be shown in the keyhint dialog
prompt-radius | The rounding radius for the edges of prompts.
prompt-filebrowser | Show a filebrowser in upload/download prompts.

Table 3. Quick reference for section “network”
Setting | Description
--- | ---
do-not-track | Value to send in the `DNT` header.
accept-language | Value to send in the `accept-language` header.
referer-header | Send the Referer header
user-agent | User agent to send. Empty to send the default.
proxy | The proxy to use.
proxy-dns-requests | Whether to send DNS requests over the configured proxy.
ssl-strict | Whether to validate SSL handshakes.
dns-prefetch | Whether to try to pre-fetch DNS entries to speed up browsing.
custom-headers | Set custom headers for qutebrowser HTTP requests.
netrc-file | Set location of a netrc-file for HTTP authentication. If empty, ~/.netrc is used.

Table 4. Quick reference for section “completion”
Setting | Description
--- | ---
show | When to show the autocompletion window.
download-path-suggestion | What to display in the download filename input.
timestamp-format | How to format timestamps (e.g. for history)
height | The height of the completion, in px or as percentage of the window.
cmd-history-max-items | How many commands to save in the command history.
web-history-max-items | How many URLs to show in the web history.
quick-complete | Whether to move on to the next part when there’s only one possible completion left.
shrink | Whether to shrink the completion to be smaller than the configured size if there are no scrollbars.
scrollbar-width | Width of the scrollbar in the completion window (in px).
scrollbar-padding | Padding of scrollbar handle in completion window (in px).

Table 5. Quick reference for section “input”
Setting | Description
--- | ---
timeout | Timeout (in milliseconds) for ambiguous key bindings.
partial-timeout | Timeout (in milliseconds) for partially typed key bindings.
insert-mode-on-plugins | Whether to switch to insert mode when clicking flash and other plugins.
auto-leave-insert-mode | Whether to leave insert mode if a non-editable element is clicked.
auto-insert-mode | Whether to automatically enter insert mode if an editable element is focused after page load.
forward-unbound-keys | Whether to forward unbound keys to the webview in normal mode.
spatial-navigation | Enables or disables the Spatial Navigation feature.
links-included-in-focus-chain | Whether hyperlinks should be included in the keyboard focus chain.
rocker-gestures | Whether to enable Opera-like mouse rocker gestures. This disables the context menu.
mouse-zoom-divider | How much to divide the mouse wheel movements to translate them into zoom increments.

Table 6. Quick reference for section “tabs”
Setting | Description
--- | ---
background-tabs | Whether to open new tabs (middleclick/ctrl+click) in background.
select-on-remove | Which tab to select when the focused tab is removed.
new-tab-position | How new tabs are positioned.
new-tab-position-explicit | How new tabs opened explicitly are positioned.
last-close | Behavior when the last tab is closed.
show | When to show the tab bar
show-switching-delay | Time to show the tab bar before hiding it when tabs→show is set to switching.
wrap | Whether to wrap when changing tabs.
movable | Whether tabs should be movable.
close-mouse-button | On which mouse button to close tabs.
position | The position of the tab bar.
show-favicons | Whether to show favicons in the tab bar.
width | The width of the tab bar if it’s vertical, in px or as percentage of the window.
indicator-width | Width of the progress indicator (0 to disable).
tabs-are-windows | Whether to open windows instead of tabs.
title-format | The format to use for the tab title. The following placeholders are defined:
title-alignment | Alignment of the text inside of tabs
mousewheel-tab-switching | Switch between tabs using the mouse wheel.
padding | Padding for tabs (top, bottom, left, right).
indicator-padding | Padding for indicators (top, bottom, left, right).

Table 7. Quick reference for section “storage”
Setting | Description
--- | ---
download-directory | The directory to save downloads to. An empty value selects a sensible os-specific default. Will expand environment variables.
prompt-download-directory | Whether to prompt the user for the download location.
remember-download-directory | Whether to remember the last used download directory.
maximum-pages-in-cache | The maximum number of pages to hold in the global memory page cache.
object-cache-capacities | The capacities for the global memory cache for dead objects such as stylesheets or scripts. Syntax: cacheMinDeadCapacity, cacheMaxDead, totalCapacity.
offline-storage-default-quota | Default quota for new offline storage databases.
offline-web-application-cache-quota | Quota for the offline web application cache.
offline-storage-database | Whether support for the HTML 5 offline storage feature is enabled.
offline-web-application-storage | Whether support for the HTML 5 web application cache feature is enabled.
local-storage | Whether support for the HTML 5 local storage feature is enabled.
cache-size | Size of the HTTP network cache. Empty to use the default value.

Table 8. Quick reference for section “content”
Setting | Description
--- | ---
allow-images | Whether images are automatically loaded in web pages.
allow-javascript | Enables or disables the running of JavaScript programs.
allow-plugins | Enables or disables plugins in Web pages.
webgl | Enables or disables WebGL.
css-regions | Enable or disable support for CSS regions.
hyperlink-auditing | Enable or disable hyperlink auditing (<a ping>).
geolocation | Allow websites to request geolocations.
notifications | Allow websites to show notifications.
media-capture | Allow websites to record audio/video.
javascript-can-open-windows-automatically | Whether JavaScript programs can open new windows without user interaction.
javascript-can-close-windows | Whether JavaScript programs can close windows.
javascript-can-access-clipboard | Whether JavaScript programs can read or write to the clipboard.
ignore-javascript-prompt | Whether all javascript prompts should be ignored.
ignore-javascript-alert | Whether all javascript alerts should be ignored.
local-content-can-access-remote-urls | Whether locally loaded documents are allowed to access remote urls.
local-content-can-access-file-urls | Whether locally loaded documents are allowed to access other local urls.
cookies-accept | Control which cookies to accept.
cookies-store | Whether to store cookies. Note this option needs a restart with QtWebEngine.
host-block-lists | List of URLs of lists which contain hosts to block.
host-blocking-enabled | Whether host blocking is enabled.
host-blocking-whitelist | List of domains that should always be loaded, despite being ad-blocked.
enable-pdfjs | Enable pdf.js to view PDF files in the browser.

Table 9. Quick reference for section “hints”
Setting | Description
--- | ---
border | CSS border value for hints.
mode | Mode to use for hints.
chars | Chars used for hint strings.
min-chars | Minimum number of chars used for hint strings.
scatter | Whether to scatter hint key chains (like Vimium) or not (like dwb). Ignored for number hints.
uppercase | Make chars in hint strings uppercase.
dictionary | The dictionary file to be used by the word hints.
auto-follow | Controls when a hint can be automatically followed without the user pressing Enter.
auto-follow-timeout | A timeout (in milliseconds) to inhibit normal-mode key bindings after a successful auto-follow.
next-regexes | A comma-separated list of regexes to use for next links.
prev-regexes | A comma-separated list of regexes to use for prev links.
find-implementation | Which implementation to use to find elements to hint.
hide-unmatched-rapid-hints | Controls hiding unmatched hints in rapid mode.