Dynamic Placeholders

You can make your snippets and AI commands dynamic with placeholders. The supported placeholders are:

$^1$ Only available in Snippets $^2$ Only available in AI Commands $^3$ Only available in Quicklinks $^4$ Only available when the Browser Extension is installed

Modifiers

Using modifiers, you can change the value of a dynamic placeholder using the {clipboard | uppercase} syntax. It works on all placeholders.

There are four different modifiers:

• uppercase → transforms Foo into FOO.
• lowercase → transforms Foo into foo.
• trim → transforms Foo Bar into Foo Bar. It removes the white spaces at the beginning and the end of the value.
• percent-encode → transforms Foo Bar into Foo%20Bar. It replaces special characters with their percent-encoded equivalent.
• json-stringify → transforms Foo "Bar" into "Foo \"Bar\"". It makes sure that the value can be used as a JSON string.

You can specify multiple modifiers in a row: {clipboard | trim | uppercase}.

Depending on where the dynamic placeholder is used (eg. Snippet, AI Commands, or Quicklinks), Raycast might apply some default formatting to its value:

• Quicklinks → All special characters are percent-encoded as this is ensure that the link stays valid
• AI Commands → The placeholders are wrapped with """ to make sure the AI understand third delimitation

If you do not want this default formatting to apply to a placeholder, you can use the special raw modifier (eg. {clipboard | raw}).

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}

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.

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..

Argument Options

You can specify some predefined options to choose from: {argument name="tone" options="happy, sad, professional"}.

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.

Using a clipboard offset placeholder requires the Clipboard History to be enabled

Browser Tab Format

By default, the content of the tab will be transformed as Markdown. However there are some cases where this isn’t the type of content you are looking for and in such cases, you can specify the format of the inserted content.

There are 3 different formats available:

• {browser-tab format="markdown"} - default
• {browser-tab format="text"} - the entire text content of the tab without any styling
• {browser-tab format="html"} - the entire html content of the tab

Browser Tab Selector

You can specify a CSS selector to precisely get the content you want with {browser-tab selector="a.author.text-bold"}. This enables you to create highly specific commands for certain websites.