Source: https://metadock.app/docs/settings

# Settings & Privacy

Every preference in MetaDock lives in one searchable Settings panel, organized into categories down the left. This page documents every setting, what it does, and the options it offers. Press Ctrl+, or choose Settings from the menu, and the panel floats over your layout instead of opening a tab. Use the search bar at the top to jump straight to any option. Press Escape or click your layout to close it.

## How are the settings organized?

Settings are grouped into categories in a sidebar on the left. The button next to the search bar hides the sidebar down to a strip of icons, and MetaDock remembers your choice. Which categories appear depends on your edition and which features it includes.

Category and What you'll find

| Category | What you'll find |
| --- | --- |
| General | Auto-save, auto-start with Windows, default search engine, download folder, multi-stream downloads, and the first-run setup. |
| Appearance | Theme, fonts, per-surface colors, icon size, divider size, and window transparency. |
| Layout & UI | How new windows, links, and dialogs open, title-bar behavior, floating windows, and suggestion timing. |
| Browsing | JavaScript, default zoom, link preview, and what browser title bars show. |
| Ad blocking | Turn ad and tracker blocking on, manage the filter lists, and set site exceptions. |
| Privacy & Protection | Fingerprint protection, the password vault, tracking prevention, stealth modes, privacy password, site permissions, and telemetry. |
| Shortcodes | Short codes you type in the address bar to jump to a saved URL. |
| Applications | Dock external Windows apps beside your browsers, and control which apps appear in the mount list. |
| Trading | Enable trading and Quick Symbol tools, and choose how multiple charts open. |
| API, Automation & AI | Turn on MCP and the command line (every plan) and REST, WebSocket, WebDriver, and CDP (MetaDock Pro), manage keys, control access, and store the provider keys the built-in AI assistant uses. |
| Keyboard Shortcuts | Rebind any keyboard action to keys you prefer. |
| Export/Import | Back up your whole installation to an encrypted file, or restore one. |
| About | Your installed version and edition, plus licence and machine management and an invite link. |

Note

There is no separate **AI** category: the assistant's provider keys and model settings sit under **API, Automation & AI**, alongside the automation transports they share a tool catalog with.

Note

Some settings are edition-specific. **API, Automation & AI** appears on every edition, but on the free MetaDock its REST, WebSocket, WebDriver and CDP switches are greyed out until you upgrade to MetaDock Pro. The fingerprint protection switch is part of MetaDock Pro and does not appear on the free MetaDock. **Ad blocking**, **Applications**, **Trading**, and **Keyboard Shortcuts** appear only in builds that include those features, so your Settings panel may show fewer tabs than the list above.

## How do I find a specific setting?

The search bar at the top of Settings is the fastest way to find anything. Start typing a setting name to filter across every category at once. The filter button next to the search bar also offers quick tokens that narrow the list:

`@modified`Only settings you've changed from their defaults.

`@appearance`Appearance settings (theme, colors, fonts, transparency).

`@layout`Layout & UI settings (window, link, and dialog behavior).

`@browsing`Browsing settings (JavaScript, zoom, link preview, title details).

`@api`API, Automation & AI settings (transports, host, port, keys, access). @ai does the same.

A **Reset to Defaults** button restores settings to their factory values if you want a clean slate.

Tip

**Troubleshooting:** if something is not behaving the way you expect, type `@modified` in the search bar to see everything you have changed. The fix is often reverting a setting you forgot you touched.

## What is in General settings?

The basics that apply across the whole app: whether workspaces auto-save, whether MetaDock launches with Windows, which search engine the address bar uses, where downloads are saved, and how large downloads are fetched. Auto-save is on by default, so a crash or restart never costs you your layout.

Setting and What it does

| Setting | What it does |
| --- | --- |
| Auto-Save | Saves your workspace automatically whenever you make a change. On by default, so a crash or restart never costs you your layout. |
| Auto-start with Windows | Launches MetaDock when Windows starts. Off by default. |
| Default Search Engine | The engine used when you type a query into the address bar. Over 20 are built in, including Google, Bing, DuckDuckGo, Yahoo, Yandex, Ask, Reddit, YouTube, and regional Amazon, eBay, and BestBuy. Google is the default. |
| Default Download Directory | The folder new downloads are saved to. |
| Multi-Stream Downloads | Downloads a large file over several connections at once when the server allows it, which is often faster. For example, a big installer arrives in parallel pieces. Off by default. |
| Multi-Stream Connections | How many connections each multi-stream download uses, from 2 to 8. The default is 4. |
| First-Run Setup | Opens the setup wizard again so you can review your theme, browsing, and AI tool choices. |

## What can I change about the appearance?

Control the entire look of the app, from the active theme down to individual surface colors.

Setting and What it does

| Setting | What it does |
| --- | --- |
| Theme | The active color theme. Pick a built-in theme or one you have built yourself (see Themes below). |
| Dark/Light Mode (Browser) | The color-scheme preference passed to web pages, so sites that support it render in Dark Theme or Light Theme. |
| Font | The application font family and size used throughout the interface. |
| Color customization | A color picker for every surface: panel background and text, input background and text, buttons, selection, links, tooltips, edges, shadows, separators, and the accent. 21 colors in all, edited in the theme editor below. |
| Icon Size | Scales interface icons from 50% to 200% so the toolbar matches your display and eyesight. |
| Resize Grip Size | The width of the draggable dividers between panels, from 1 to 16 pixels. Larger grips are easier to grab. |
| Window Transparency | Translucent window backgrounds with a blur effect on Windows 10 and 11. |
| Transparency Level | How opaque the background is when transparency is on, from 0 to 255. Lower is more see-through. |

## How do I build my own theme?

MetaDock ships with eight built-in themes: two light (Light, Blue) and six dark (Dark, Classic, Future, Dark Blue, Tuxedo, Terminal). Dark Blue is the default on a new install.

Light

Blue

Dark

Classic

Future

Dark Blue

Tuxedo

Terminal

You can also build your own. Open the theme editor from **Appearance → Theme Management**:

-   •Color picker for every surface: panels, inputs, buttons, selection, links, tooltips, edges, shadows, and the accent, with a live preview as you go.
-   •Built-in contrast check: stops you from choosing a text and background combination that would be unreadable.
-   •Duplicate & Modify: built-in themes cannot be edited directly, so the editor makes an editable copy for you to tweak.
-   •Save, Rename, Remove: manage your custom themes (built-in themes cannot be renamed or removed).
-   •Export & Import: save a theme to a JSON file to back it up or share it, and import themes from a file.
-   •Reset Defaults: restores the built-in themes to their factory colors without touching your custom ones.

## Which layout and interface options can I change?

Decide how windows, links, and panels appear, and how the chrome behaves.

Setting and Options

| Setting | Options |
| --- | --- |
| New Window Behavior | How new browsers and apps are created: Workspace Panel (docked into the tiled layout), Floating Window (a free window you can move anywhere), or Tabbed Interface (a new tab inside an existing dock panel). |
| New Link Behavior | How 'open in new window' links behave: Workspace Panel, Floating Window, or Tabbed Interface, using the same three modes as above. |
| Settings Opens As | Floating Window (over the layout; Esc or a click on the layout closes it) or Workspace Panel (a docked panel saved with the workspace). Floating by default. |
| Bookmarks Opens As | Floating Window or Workspace Panel, as above. Floating by default. |
| Downloads Opens As | Floating Window or Workspace Panel, as above. Floating by default. |
| History Opens As | Floating Window or Workspace Panel, as above. Floating by default. |
| Credential Vault Opens As | Floating Window or Workspace Panel, as above. Floating by default. |
| AI Agent Opens As | Floating Window or Workspace Panel, as above. Floating by default. Closing the floating agent only hides it, so a reply in progress keeps going. |
| Title Bar Mode | Title bars on panels and browsers: Always Show, Always Hide, or Auto-hide (they slide in when you move the cursor near the top edge of a panel). |
| Auto Suggest Interval | The delay before address-bar suggestions appear, from 100 to 3000 ms. Lower feels snappier; higher waits until you pause typing. |
| Disable Floating Windows | Keeps windows inside the docked area instead of letting them float free. On by default. |

## Which browser settings can I change?

Browser defaults are split across three categories: **Browsing**, **Ad blocking**, and **Shortcodes**. They apply to every browser you open, and most can be overridden per profile or per browser.

Setting and What it does

| Setting | What it does |
| --- | --- |
| Enable JavaScript | Turns JavaScript on or off for all browser panels. On by default. |
| Default Zoom Level | The zoom level new browsers open at, from 25% to 500%. |
| Extended Title: Always Show Profile | Adds the profile name to window title bars so you always know which identity a browser belongs to. |
| Extended Title: Always Show Proxy | Adds the proxy status to window title bars. |
| Link Preview on Alt+Hover | Hold Alt and hover over a link to see a small screenshot preview of where it leads, rendered by a single reusable background browser. |

The **Ad blocking** category holds ad and tracker blocking:

Setting and What it does

| Setting | What it does |
| --- | --- |
| Block ads | Blocks ads and trackers using filter lists. Can be overridden per profile and per browser. |
| Filter Lists | Toggle, update, or remove the built-in block lists, and add your own by URL. |
| Adblock Site Exceptions | Sites where ad blocking is turned off, kept per profile. An entry also covers its subdomains. |

The **Shortcodes** category holds one editor:

Setting and What it does

| Setting | What it does |
| --- | --- |
| URL Shortcodes | Save short codes that expand to full URLs. Type a shortcode in the address bar to jump straight to its destination. |

Note

See the [Ad & Tracker Blocking](https://metadock.app/docs/adblock) page for how the engine and lists work.

## Which settings control docked applications?

Dock native Windows applications into the same tiled layout as your browsers.

Setting and What it does

| Setting | What it does |
| --- | --- |
| App Support | Allows external Windows applications to be docked alongside your browsers. You accept a short notice the first time you turn it on. |
| Mountable App Privacy | Hide the New Tab running-app list while screen-sharing, or hide specific applications from it. |

Note

Compatibility varies by app. See the [Docking Apps](https://metadock.app/docs/apps) page for details.

## Which settings control the trading tools?

Two. One switches the trading and Quick Symbol tools on, including the keyboard symbol search that opens a ticker across every chart at once. The other decides whether those charts open as separate docked panels or as tabs in one floating window.

Setting and What it does

| Setting | What it does |
| --- | --- |
| Trading Features | Enables the trading and Quick Symbol tools, including the keyboard symbol search for opening a ticker across your charts at once. |
| Quick Symbol Charts | How chart windows open for multiple symbols: Workspace Panels (each chart as its own docked panel) or Single Floating Window (all charts as tabs in one floating window). |

Note

For how the trading tools work, see [Tools](https://metadock.app/docs/tools#trading-tools).

## Which privacy and security settings are available?

The **Privacy & Protection** category holds everything that controls what is visible, what is remembered, and how your identity is protected.

Setting and What it does

| Setting | What it does |
| --- | --- |
| Fingerprint Protection | Limits what websites can read about your device to recognize you across profiles. This switch is the app-wide agreement: a profile is protected only while this is on and that profile's own protection is on. Off until you turn it on. Beta, MetaDock Pro only. |
| Password Autofill (MetaDock Credential Manager) | When on, MetaDock's master-password vault handles autofill and save prompts. When off, the browser's built-in password manager takes over instead. Changing this requires a restart for already-open browsers. |
| Import Passwords from File | Import logins from a CSV (Chrome, Edge, Firefox, Safari, LastPass, Dashlane, NordPass), a Bitwarden JSON export, or a 1Password .1pux export. Shown only while Password Autofill is on. |
| Tracking Prevention Level | How strictly trackers are blocked: Disabled, Basic (blocks known malicious trackers, allows most analytics), Balanced (blocks most trackers while keeping sites working), or Strict (blocks all trackers, may break some sites). |
| Privacy Features | Enables the instant hide and stealth features (F2 and F8). See Stealth Modes below. |
| Set Privacy Password | Sets a password so hidden browsers and the hidden interface cannot be revealed without it. |
| Clear Privacy Password | Removes the privacy password (you must enter the current one to clear it). |
| Site Permissions | View, change, and forget remembered site permission decisions for each profile, such as camera, microphone, location, and notifications. |
| Usage Telemetry | Sends pseudonymous health and feature-count data, and enables crash reports. Turn it off here at any time; the change takes effect immediately. |

Note

MetaDock shows you a one-time notice about telemetry on first run. The exact fields sent, and the much longer list of what is never sent, are itemised in the [privacy policy](https://metadock.app/privacy). Turning this off also stops crash reports being sent.

Note

The credential vault is a Beta feature. See the [Password Vault](https://metadock.app/docs/password-vault) page for how the master password and encryption work, and the [Anti-Fingerprint](https://metadock.app/docs/anti-fingerprint) page for the per-profile protection options.

## What do the privacy and stealth modes do?

MetaDock includes instant-hide modes designed for sensitive environments, whether you are at work, sharing a screen, or just need privacy in a hurry. Turn them on with **Privacy Features** in Settings.

#### F8: Hide & Mute a Single Browser

Press F8 on any browser panel to instantly hide its content and mute its audio. The panel goes blank so nobody can see what was on it.

**Use case:** someone walks up while you are browsing something personal. F8 hides just that panel; your other panels stay visible and normal.

#### F2: Hide the Entire Interface

Press F2 to completely hide MetaDock's interface and mute all audio. The whole application disappears.

**Use case:** you are about to share your screen. F2 hides everything at once. When you are done, press F2 again (or enter your password) to bring it all back.

#### Ctrl+Alt+M: Mute All

Mute or unmute every browser and media source in one keystroke.

Note

Both F8 and F2 support **optional password protection**. Set one with **Set Privacy Password**in Settings → Privacy & Protection, and nobody can reveal the hidden content without it. These features can also be disabled entirely if you do not need them.

## Where do I turn on the automation APIs and AI?

One unified panel turns on the automation surfaces, manages keys, and controls who can connect. It opens fresh each time so the status and usage you see are always current.

Note

This category is on every plan. MCP, the local CLI connection, the API keys, the access lists and the built-in AI assistant work on the free MetaDock, within its limits. The REST, WebSocket, WebDriver and CDP switches are part of MetaDock Pro; on the free MetaDock they are greyed out.

#### Status & Usage

A header showing the live base URL your tools should point at, plus your current request usage.

#### Endpoints

Per-transport toggles for REST, WebSocket, MCP, WebDriver (Selenium), and CDP, plus the host and port. The default is `127.0.0.1:8080`. Transport toggles take effect the moment you flip them. Host and port are different: they are bound when the server starts, so changing them needs an **Apply & restart** and MetaDock tells you to restart the app before the new address is live.

#### Keys

An embedded multi-key manager for creating and revoking API keys, plus a one-click installer that adds MetaDock to desktop tools like Claude Desktop and Cursor.

#### Access

An Allow-All toggle above two allowlists: an approval allowlist of MCP and CLI connections you have authorized, and an MCP endpoint allowlist of the remote addresses allowed to connect. Allow-All lets MCP and CLI connections in without asking; it lasts for the current session only and switches itself back off when MetaDock restarts. REST, WebSocket, CDP and WebDriver need only an API key.

#### AI provider keys

Below the automation panel, the API keys for the cloud AI providers the built-in assistant talks to. They live here rather than in a category of their own because the assistant drives MetaDock through the same tool catalog as MCP.

Note

For request and response details, see the [API reference](https://metadock.app/api-docs). For connecting AI agents over MCP, see the [MCP](https://metadock.app/mcp) page.

## Where are shortcuts, export/import, and version info?

Three separate categories at the bottom of settings. Keyboard Shortcuts rebinds any action and resets everything to defaults, Export/Import writes or restores the whole installation as one encrypted file, and About shows your installed version and edition alongside your licence and the machines it is activated on.

Category and What it does

| Category | What it does |
| --- | --- |
| Keyboard Shortcuts | Rebind any keyboard action to keys you prefer, and reset all bindings back to their defaults. |
| Export/Import | Back up your whole installation to a single encrypted file, or restore one. |
| About | Shows your installed version and edition, and links out to manage your licence and activated machines or invite a friend. |

Note

For the full list of default bindings, see the [Keyboard Shortcuts](https://metadock.app/docs/keyboard-shortcuts) page. Export/Import is covered in detail on the [Backup & Restore](https://metadock.app/docs/backup) page. The built-in assistant is a Beta feature; its provider keys live under **API, Automation & AI** above, and the assistant itself is covered on the [AI Assistant](https://metadock.app/docs/ai-assistant) page.

## How does MetaDock update itself?

MetaDock checks for a newer version in the background, shortly after launch and periodically while it runs. The check is silent: it never interrupts you with a dialog or a notification.

When a newer version is available, an update button appears in the title bar. That button is the only signal, so if you do not see it, you are on the current version. You can always confirm which version you are running under **About**.

Clicking the update button walks you through it:

1.  MetaDock tells you which version is available and asks whether to download it
2.  The installer downloads to your Downloads folder, with a progress dialog
3.  When it finishes, confirm and MetaDock launches the installer for you

Note

MetaDock does not close itself for the update, so quit it when the installer asks. The installer updates your existing install in place: profiles, workspaces, settings, and your vault are all kept. You can also grab the installer yourself from the [download page](https://metadock.app/download) at any time.

Settings govern the features the tour covers. [See the full feature tour](https://metadock.app/features).

Trying this yourself? MetaDock is free, and the first 14 days include MetaDock Pro, with no account, email or card.

[Download free](https://metadock.app/download)
