Skip to main content

Settings reference

Open Clipped's settings window from the gear icon in the panel's bottom bar, or from the quick menu (Option-click the menu bar icon → Settings).

The window has three tabs: General, Transformations, and App rules.

General

General

SettingDescriptionDefault
Launch at loginStart Clipped automatically when you log in (uses SMAppService)Off
Persist history across rebootsSave history to disk and reload it on next launchOff
Play sound on copyPlay a subtle tick whenever an item is capturedOn
History sizeMaximum number of items to keep (10, 25, 50, 100, 250, 500)100

When you lower the history size, older items are trimmed immediately.

Screenshots

SettingDescriptionDefault
Capture screenshots to historyWatch a folder for new screenshots and add them automaticallyOff

Enabling this will prompt you to select your screenshots folder (typically ~/Desktop or ~/Pictures/Screenshots). Clipped stores an app-scoped bookmark so it can keep watching after relaunch.

Security

SettingDescriptionDefault
Secure mode (password manager entries)Treat clipboard content flagged by password managers (via the org.nspasteboard.ConcealedType hint) speciallyOn
Password itemsSkip entirely, or remove from history after 10 / 30 / 60 secondsSkip entirely

Secure mode uses the standard pasteboard "concealed" hint that 1Password, Bitwarden, and similar apps set. Clipped still won't leak those entries to disk even if you pick one of the timeouts.

Separately, Clipped automatically detects API-key and secret patterns (Stripe, Clerk, GitHub tokens, webhook secrets, JWT-style prefixes, etc.) and masks them in previews and the detail pane. The raw bytes still round-trip through the clipboard so you can paste them normally — they just don't sit in plain view on your screen.

Privacy

SettingDescriptionDefault
Fetch link previewsWhen a URL is copied, fetch its page title and favicon from the origin serverOn

Disable this to keep copied URLs fully local — no outbound network requests are made for any reason. Previews already fetched are kept.

Filter tabs

Choose which category tabs appear above the clipboard panel. Tabs are grouped into three sections:

  • Content type — Text, URL, Image, Dev. These are on by default.
  • Smart categories — Email, Phone, Color, Number. Off by default, powered by content pattern matching.
  • Source app — Chat, Browser, Editor, Terminal. Off by default, bucketed by the bundle ID of the source app.

The All tab is always shown. Hidden tabs stay hidden until you re-enable them here.

Keyboard shortcuts

Two global shortcuts are rebindable. Click a recorder, press a combination, and Clipped re-registers it via the Carbon hotkey API.

ShortcutDefaultAction
Open clipboard panel⌥COpens the compact panel beneath the menu bar
Open full history window⌥⇧COpens the standalone three-pane history browser

The Reset to defaults button restores both original bindings.

About

Shows the current version and a reminder that clipboard history never leaves your device.

Transformations

Clipped can automatically rewrite clipboard content as it's captured. Each rule is a toggle with a plain description:

TransformationApplies toDefault
Strip tracking parametersURLsOn
Trim whitespacePlain textOn
Clean Amazon linksURLsOff
Smart quotes → straightPlain textOff
Collapse multiple spacesPlain textOff
Strip to plain textRich textOff
Convert to MarkdownRich textOff
Strip ANSI codesPlain textOff
Detect code snippetsPlain textOff

Mutated items show a ✦ badge in the panel. Right-click an item and choose Restore original to revert it.

App rules

Override any transformation for a specific source app. Apps appear in this list after you've copied something from them. For each app you can set any rule to Default (use the global setting), On, or Off. Useful for e.g. keeping whitespace intact when copying from a terminal, or forcing Markdown conversion out of Notes.

Storage location

Clipped stores its history JSON and thumbnails at:

~/Library/Application Support/Clipped/

The history file is encrypted at rest with a key stored in the macOS Keychain. There's no cloud sync, telemetry, or account. If you want to reset Clipped completely, quit it and remove that directory (the Keychain entry is rotated automatically on next launch).