Skip to content
CleverKeys Wiki

Clipboard History

CleverKeys maintains a history of everything you’ve copied — text, images, videos, PDFs, and more — making it easy to paste items from earlier.

Quick Summary

WhatDescription
PurposeAccess previous clipboard items (text + media)
AccessSwipe SW from Ctrl key, or add Clipboard to Extra Keys
CapacityConfigurable (default 50 items)

Accessing Clipboard History

Method 1: Ctrl Key Swipe

  1. Find the Ctrl key on the bottom row
  2. Swipe SW (down-left) to activate switch_clipboard
  3. Clipboard history panel opens
  4. Tap any item to paste

Method 2: Extra Keys

If you’ve added a clipboard key to Extra Keys:

  1. Tap the clipboard icon in your extra keys row
  2. History panel opens
  3. Tap item to paste

Method 3: Per-Key Customization

You can assign clipboard access to any key’s short swipe:

  1. Go to Settings > Activities > Per-Key Customization
  2. Select any key
  3. Assign switch_clipboard to a swipe direction

Using Clipboard History

Paste from History

  1. Open clipboard history
  2. Tap any item
  3. Item is pasted at cursor position

Delete Item

  1. Open clipboard history
  2. Tap the 🗑 delete button on the item

Long-Press to Copy

Copy an item to the system clipboard without pasting it into the current field:

  1. Open clipboard history
  2. Long-press any item’s text
  3. A “Copied to clipboard” toast confirms the action
  4. The text is now on the system clipboard — paste it in any app

This is useful when you want to store text for use in another app without inserting it into the current text field.

Pin Items

Keep important items from being removed:

Pin an Item

  1. Open clipboard history (History tab)
  2. Tap the 📌 pin button on the item
  3. Item is added to the Pinned tab

Unpin Item

  1. Switch to the Pinned tab (📌)
  2. Tap the 📌 pin button on the item to unpin
  3. Item is removed from Pinned tab

Pinned items:

  • Appear in the dedicated Pinned tab
  • Don’t auto-expire
  • Don’t count toward history limit

Pinned Entry Shortcuts

You can bind pinned clipboard entries to swipe gestures using the paste_pinned_1 through paste_pinned_5 commands. This lets you insert frequently used pinned text with a single swipe, without opening the clipboard panel.

Entries are numbered by position (most-recently-pinned first):

  • paste_pinned_1 inserts your most recently pinned entry
  • paste_pinned_2 inserts the second, and so on up to paste_pinned_5

To set this up, go to Settings > Activities > Per-Key Customization, choose a key and direction, select Command, and search for “paste_pinned”. See Per-Key Actions for full details.

Todo Items

Mark clipboard items as to-do reminders:

Add to Todos

  1. Open clipboard (History or Pinned tab)
  2. Tap the ✓ todo button on the item
  3. Item is added to the Todos tab

Mark as Done

  1. Switch to the Todos tab (✓)
  2. Tap the ✓ todo button to remove from todos
  3. Item is removed from Todos tab (still in history)

Todo items:

  • Appear in the dedicated Todos tab
  • Can also be pinned (both flags independent)
  • Useful for quick reference or follow-up

Media Clipboard

CleverKeys automatically captures images, videos, PDFs, and other files you copy to the clipboard.

Supported Media Types

TypeExamplesThumbnail
ImagesJPEG, PNG, WebP, GIFPhoto preview
AnimatedAnimated GIF, animated WebPFirst frame + play badge
VideosMP4, QuickTimeVideo frame preview
PDFsPDF documentsFirst page preview
Other filesZIP, documentsMIME-type icon

How Media Clipboard Works

  1. Copy an image/video/file in any app (Gallery, Chrome, Files, etc.)
  2. CleverKeys captures it automatically in the background
  3. A thumbnail appears in clipboard history
  4. Tap the media entry to paste it into the current app (via commitContent)

Media Paste

  • Media is pasted via Android’s commitContent API — the receiving app must support it
  • Most messaging apps (Signal, Telegram, WhatsApp) and text editors support image paste
  • If the app doesn’t support media paste, a “Cannot paste media here” message appears
  • Long-press a media entry to copy the media URI to the system clipboard

Media Settings

SettingDescriptionDefault
Media ClipboardEnable/disable media captureOn
Text-Only ModeHide all media, show only text entriesOff
Max Media SizeMaximum file size for media entries (1-50 MB)10 MB

To access: Settings > Clipboard section (expand it) or Settings > Activities > Clipboard Settings.

[!TIP] If you only want text in your clipboard and find media entries distracting, enable Text-Only Mode. Media will still be captured (unless you also disable Media Clipboard) but won’t appear in the panel.

Tab System

The clipboard pane organizes items into three tabs:

TabIconDescription
History📋Recent clipboard history (default)
Pinned📌Items you’ve pinned for quick access
TodosItems marked as to-do reminders

Switching Tabs

  1. Open clipboard pane
  2. Tap the tab icon (📋, 📌, or ✓) in the header row
  3. Active tab is fully visible (alpha 1.0), inactive tabs are dimmed (alpha 0.5)

Item Actions by Tab

ActionHistory TabPinned TabTodos Tab
Pin buttonPins itemUnpins itemPins item
Todo buttonAdds to todosAdds to todosRemoves from todos
DeleteDeletes itemDeletes itemDeletes item
PastePastes to editorPastes to editorPastes to editor
Long-pressCopies to system clipboardCopies to system clipboardCopies to system clipboard

Pagination

For large clipboard histories (>100 items), pagination improves performance:

  • Items are displayed 100 per page
  • Pagination bar appears at the bottom when needed
  • Shows current page / total pages (e.g., “1 / 6”)
  • ◀ and ▶ buttons navigate between pages
  • Search still searches ALL items across all pages
┌─────────────────────────────────────┐
│ [◀]         3 / 6              [▶]  │
└─────────────────────────────────────┘

History Panel Layout

┌─────────────────────────────────────┐
│ 📋 📌 ✓  [Search...]  🔽  [▼]      │ ← Tabs + Search + Filter + Close
├─────────────────────────────────────┤
│ Recently copied text here... [📌✓🗑]│ ← Text entry
│ [thumb] photo.jpg · 2h ago   [📌✓🗑]│ ← Image entry with thumbnail
│ [▶vid] clip.mp4 · Yesterday  [📌✓🗑]│ ← Video entry with play badge
│ Another clipboard item...    [📌✓🗑]│ ← Text entry
├─────────────────────────────────────┤
│ [◀]         1 / 3              [▶]  │ ← Pagination (if >100 items)
└─────────────────────────────────────┘

Privacy Features

Password Manager Exclusion

CleverKeys can exclude clipboard entries from password managers:

SettingBehavior
EnabledClips from 1Password, Bitwarden, etc. not saved
DisabledAll clips saved normally

Supported apps include: 1Password, Bitwarden, LastPass, Dashlane, KeePass variants, and more.

Password Field Detection

CleverKeys automatically detects password fields:

BehaviorDescription
Don’t savePassword field text not saved to history
Mask displaySensitive items may show masked

Tips and Tricks

  • Pin frequently used: Pin items you paste often
  • Clear sensitive data: Regularly clear history with sensitive info
  • Quick access: Add clipboard to Extra Keys for one-tap access
  • Customize access: Assign clipboard to any key via Per-Key Customization

[!TIP] The Ctrl key’s SW subkey is switch_clipboard by default on most layouts.

Settings

SettingLocationDescription
Enable HistoryClipboard sectionTurn history on/off
History SizeClipboard sectionMaximum items to keep
History DurationClipboard sectionAuto-expiry (default: never)
Max Item SizeClipboard sectionPer-item text size limit (64-1024 KB)
Media ClipboardClipboard sectionEnable/disable media capture
Text-Only ModeClipboard sectionHide media, show only text
Max Media SizeClipboard sectionMaximum media file size (1-50 MB)
Pinned TabClipboard sectionShow/hide the Pinned tab
Todo TabClipboard sectionShow/hide the Todos tab
Exclude Password ManagersClipboard sectionDon’t save from password apps
Respect Sensitive FlagClipboard sectionHonor Android 13+ IS_SENSITIVE

Clear History

To clear clipboard history, use the export/import features in Settings > Backup & Restore, or delete items individually using the delete button on each item.

Common Questions

Q: Why don’t I see clipboard history?

A: Check that it’s enabled in Settings > Clipboard section (expand it).

Q: How do I access clipboard quickly?

A: Swipe SW (southwest/down-left) on the Ctrl key, or add a clipboard key to your Extra Keys.

Q: Why wasn’t my copied text saved?

A: It may have been from a password field or a password manager app (if exclusion is enabled).

Q: Can I recover deleted items?

A: No, deleted items cannot be recovered. Pin important items.

Q: Why don’t I see images in my clipboard?

A: Check that Media Clipboard is enabled and Text-Only Mode is off in Settings > Clipboard section. The source app must also provide a content URI when copying (most apps do).

Q: Can I paste an image from clipboard into a messaging app?

A: Yes — tap the image entry in clipboard history. It uses Android’s commitContent API. The receiving app must support media input (most modern messaging apps do).