Settings

Settings

Open the SETTINGS dialog from the side-menu header (gear button). Settings are organized into four tabs across the top — GENERAL, APPEARANCE, NETWORK, and WORKSPACE — and the dialog opens on GENERAL. Everything here saves immediately. On narrow widths the dialog opens full-screen with the same tabs along the top.

General

Setting	Type	Default	What it does
HISTORY LIMIT	number	100	Max History entries kept; lowering it trims older ones.
SAVE RESPONSE	toggle	off	Store response bodies in history (not just request metadata).
ALWAYS PRETTIFY LARGE RESPONSES	toggle	off	Auto-format & highlight large [[Responses
RESPONSE HISTORY (PER TAB)	number	5	How many recent responses to keep per tab for [[Responses#response-history-time-travel
SAVE LARGE RESPONSES IN HISTORY	toggle	on	When off, responses over ~512 KB are kept in history as metadata only (no body), to bound storage.
CHECK FOR UPDATES ON STARTUP	toggle	on	Check GitHub for a newer version at launch and prompt if one's found. Desktop only. See Auto-Update.

The General tab also has an UPDATES row showing the current version with a CHECK FOR UPDATES button for an on-demand check (desktop only) — see Auto-Update.

Appearance

Setting	Type	Default	What it does
DARK MODE	toggle	off	Light ↔ dark variant of the active theme.
THEME	dropdown	CLASSIC	Pick CLASSIC / BRUTALIST / EDITORIAL / ARCANE QUEST / DRACULA / LIQUID GLASS. See Themes and Appearance.
COMPACT MODE	toggle	off	Denser spacing, smaller fonts/icons.

Network

The NETWORK tab holds the connection settings below plus the Client certificate (mTLS) and Cookies controls. All timeouts are in milliseconds.

Setting	Type	Default	What it does
CONNECT TIMEOUT (ms)	number	30000	Max time to establish a connection.
SEND TIMEOUT (ms)	number	30000	Max time to send the request body.
RECEIVE TIMEOUT (ms)	number	60000	Max time to receive the response.
FOLLOW REDIRECTS	toggle	on	Follow HTTP 3xx redirects automatically.
MAX REDIRECTS	number	5	Redirect cap (shown when Follow Redirects is on; clamped to ≥ 1).
VERIFY SSL	toggle	on	Validate TLS certificates. Turn off only for testing self-signed/invalid certs.
PROXY (host:port)	text	—	Route traffic through an HTTP proxy, e.g. 127.0.0.1:8888. Empty = no proxy.

Client certificate (mTLS)

For servers that require a client certificate. Desktop/mobile only (the web build shows "Available in the desktop/mobile app." — browsers manage client certs themselves).

• CHOOSE CERT — pick a PEM certificate file.
• CHOOSE KEY — pick the PEM private-key file.
• KEY PASSPHRASE (optional) — passphrase for an encrypted key (obscured field).
• CLEAR — remove cert, key, and passphrase (shown once any is set).

Getman reads the files at send time and applies them to the TLS connection. The settings store file paths (and the passphrase), not the key material itself.

Cookies

• MANAGE — open the Cookies (inspect/delete per cookie).
• CLEAR — empty the whole cookie jar (confirmed).

Workspace

The WORKSPACE tab holds a single control:

• Workspace settings — configure a Import Export and Git Workspace folder (desktop only) that mirrors your collections to readable JSON files.

Other persisted preferences

A few things are saved automatically (no dialog control): the active Environments and Variables, the side-menu width, and the request/response split ratio (both set by dragging — see The Interface).