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.