You can make your snippets and AI commands dynamic with placeholders. The supported placeholders are:
Name | Placeholder | Description |
Clipboard Text | {clipboard} | Inserts your last copied text. The placeholder will be removed from the snippet when you use it if you have not copied any text recently. |
Cursor Position¹ | {cursor} | Moves cursor to the position when pasted directly into an app or injected. Please note that a snippet can contain only one placeholder of this type. |
Date¹ | {date} | Inserts only the current date like 1 Jun 2022. |
Time¹ | {time} | Inserts only the current time like 3:05 pm. |
Date & Time¹ | {datetime} | Inserts both date and time like 1 Jun 2022 at 6:45 pm. |
Weekday¹ | {day} | Inserts the day of the week like Monday. |
UUID¹ | {uuid} | Inserts a universally unique value, such as “E621E1F8-C36C-495A-93FC-0C247A3E6E5F”. |
Selected Text² | {selection} | Inserts the selected text from the frontmost application. In the context of the AI Chat, the previous message will be inserted instead. |
Argument² | {argument} | Add an input in the search bar. The placeholder will be replaced by the argument’s value. |
¹ Only available in Snippets ² Only available in AI Commands
Date & Time offset
By default, if you use a date/time placeholder, its value will be set to the current date/time when you insert the snippet. To display a different date/time, you can do offsets using modifiers like +2d, -3M etc. This will change the value from the current date/time to the defined offset.
A modifier is made up of 3 components,
- it begins with a “plus” or “minus” symbol, to denote the direction of the offset from the current date/time
- the symbol is followed by a number
- at the end we have a single letter representing the unit of the offset. You can use “m” for minutes, “h” for hours, “d” for days, “M” for months and “y” for years.
You should use spaces inside the braces to separate the modifier from the keyword. Also, you can add multiple modifiers in a single placeholder each separated by a single space.
For example, you can write placeholders like the following
{date offset="+2y +5M"}{time offset="+3h +30m"}{day offset=-3d}{datetime offset=+1h}
{date offset="+ 2d"} is not a valid placeholder.As you can see in the below image, whenever you enter a proper placeholder, the curly braces will turn blue to indicate it. If your keyword or modifier is different from what is described above, you will see the braces remain in the same text color.
Custom Date Formats
The format of the date/time placeholders depends on your system preference. You can see samples of the format on the right side of each placeholder when inserting.
Apart from the four system defined date placeholders, you can create date placeholders in your preferred format by creating a placeholder like {date format="yyyy-MM-dd"}.
Here are some more examples of date placeholders with custom formats and their expected output.
Placeholder | Output |
{date format="EEEE, MMM d, yyyy"} | Wednesday, Jun 15, 2022 |
{date format="MM/dd/yyyy"} | 06/15/2022 |
{date format="MM-dd-yyyy HH:mm"} | 06-15-2022 13:44 |
{date format="MMM d, h:mm a"} | Jun 15, 1:44 PM |
{date format="MMMM yyyy"} | June 2022 |
{date format="MMM d, yyyy"} | Jun 15, 2022 |
{date format="E, d MMM yyyy HH:mm:ss Z"} | Wed, 15 Jun 2022 13:44:39 +0000 |
{date format="yyyy-MM-dd'T'HH:mm:ssZ"} | 2022-06-15T13:44:39+0000 |
{date format="dd.MM.yy"} | 15.06.22 |
{date format="HH:mm:ss.SSS"} | 13:44:39.945 |
Points to Note:
- You can mix date modifiers with custom date formats like
{date format="yyyy-MM-dd" offset="+3M -5d"} - All characters inside the double quotes which you use to represent the custom format are case sensitive
- You can add text which is not part of the date format using single quote. For example, you can write
{date format="h:mm 'on the eve of' MMMM d"}which refers to 8:30 on the eve of June 5.
Argument Name
By default, every time you use an {argument} placeholder, a new input will be shown in the search bar (up to 3).
In order to reuse an argument placeholder, you have to give them a name: {argument name="tone"}, {argument name="email"}, etc.. When two argument placeholders have the same name, they will be replaced by the same value.
Argument Default Value
By default, an argument is required and you won’t be able to run the AI Command before entering a value.
You can specify a default value for the argument in order to make it optional: {argument default="happy"}, {argument name="sport" default="skiing"}, etc..
Clipboard Offset
By default, {clipboard} will insert your last copied text. If you want to insert an older copied text, you can do so with {clipboard offset=1} which will insert the second to last copied text, {clipboard offset=2} for the 3rd latest, and so on.
