**This is an old revision of the document!**
The %TriggerValue% token returns the value associated with how the macro was triggered.
Different ways of triggering the macro will set this field differently.
You can pass an explicit value in using the “with parameter” option when executing a script from AppleScript.
You can pass an explicit value in when executing the macro via the web server.
You can pass an explicit value in when executing the macro via the kmtrigger URL
It will reflect the current modifiers when triggering a macro via the Status Menu or a Palette (Note that Option means “edit this macro instead of triggering it”).
It will reflect the hot key or device key pressed.
It will reflect the application name for an application trigger.
It will reflect the name of the file added/removed from a folder.
To use the %TriggerValue% token in a numeric field, use the CALCULATE function: CALCULATE(%TriggerValue%).
You can easily access the individual parts using the token array notation, eg
%TriggerValue% will be the third comma-separated value, and
%TriggerValue;% will be the third semicolon-separated value, and
%TriggerValue % (note the space between the
] and the
%) will be the third space-separated value (8.0.4+).