Tokens allow you to add textual information to token text fields. You can tell that a field accepts tokens because a small T shows in the field while editing it.

You can insert tokens into a field using the Insert Token popup near the field or by choosing Edit ➤ Insert Token menu. You can also start typing a token and use type completion to complete the token. You can insert a token by name by choosing Edit ➤ Insert Token by Name menu.

The available tokens are listed on the wiki Tokens page.

Text token fields also process %NN% or %NNNN% as arbitrary hex unicode characters (eg %41% is an A), and (except for regular expression fields) process backslashed characters \a,\b,\e,\f,\t,\r,\n (bell,backspace,escape,form feed,tab,return,line feed).

To include a percent in your text, simply double the percent (%%). To include a backslash \ in your text, double the backslash (\\).

With tokens that commonly contain arrays of information, you can easily access the individual parts using the token array notation, eg %TriggerValue[3]% will be the third comma-separated value, and %TriggerValue[3];% will be the third semicolon-separated value, and %TriggerValue[3] % (note the space between the ] and the %) will be the third space-separated value (8.0.4+). This currently works with the following tokens:

• TriggerValue
• FrontWindow*
• Window*
• Screen*
• SystemClipboard
• PastClipboard
• NamedClipboard
• TriggerClipboard
• CurrentMouse
• FoundImage

Many actions allow you to turn off tokens or backslash character processing if you need to use text that has percent or backslash characters. You can control this by clicking the ⚙ button and using the action menu.