Skip to main content

Clipboard History

Inserts the content of the given clipboard history slot.

This placeholder supports only plain text and tracks 10 most recent clipboard entries.

iOS Compatibility​

⚠️ This feature is supported only on macOS. iOS does not allow apps to track the clipboard history.

To ensure partial compatibility, the placeholder supports only slot 1 on iOS. For other slots, it inserts #ONLY SLOT 1 IS SUPPORTED ON iOS#.

Requirements​

This placeholder requires clipboard history tracking to be enabled (App Settings -> Behaviors -> Track clipboard history).

Adding this placeholder automatically enables clipboard tracking. The clipboard is checked every 1.5 seconds.

You can always disable clipboard tracking in the settings.

Parameters​

1️⃣ Slot (default: 1)​

The clipboard history slot number from which the content should be inserted.

The slot number must be between 1 and 10.

1 is the most recent clipboard entry. 10 is the oldest entry.

Syntax​

{@clipboard-history|1@}

Notes​

When you copy something to the clipboard, it is added to the first slot and all other slots are shifted. The oldest entry is removed if the clipboard history is full.

Clipboard history is stored in memory and is not saved between app sessions. Only entries with plain text representation are stored.

Some applications may set the clipboard content for their own purposes, marking it as "autogenerated". Such entries are not added to the clipboard history.

Use Cases​

This placeholder is useful when you want to collect some information from different sources using copy to Clipboard and combine them into some generated text.

Example​

You often send a message to customers with the same structure but different details. You could create a snippet that inserts the customer name, the product name, and the price from the clipboard history:

Dear {@clipboard-history|3@},

We are happy to inform you that we have a new product in our offer: {@clipboard-history|2@}.
The price is only {@clipboard-history|1@}.

Let us know if you are interested.

This way, you can quickly copy all three pieces of information and then expand the snippet to generate the message.

Note that the clipboard history is stored in reverse order, so the last copied text is in slot 1.

To make it easier to understand, the template uses slot numbers in the reverse order. This way, you can copy information in the order as they appear in the template.

Let's say you have copied the following information in the following order:

  1. John Doe
  2. Snippet Plugin
  3. $20.99

At this point, the clipboard history looks like this:

  1. $20.99
  2. Snippet Plugin
  3. John Doe

The snippet above will insert the following text when expanded:

Dear John Doe,

We are happy to inform you that we have a new product in our offer: Snippet Plugin.
The price is only $20.99.

Let us know if you are interested.