Skip to main content

Advanced variables

Advanced variables let you insert dynamic values into fields such as header names, header values, directory paths, and other supported inputs.

Message

Misc

VariableDescription
{message:id}Unique message identifier; value of the X-MSH-Id header added by the application
{message:subject}Message subject

Size

VariableDescription
{message:size}Message size in kilobytes (default unit)
{message:size:b}Message size in bytes
{message:size:kb}Message size in kilobytes
{message:size:mb}Message size in megabytes
{message:size:gb}Message size in gigabytes

Headers

VariableDescription
{message:headers:count}Total number of message headers
{message:header:HEADER_NAME}Value of a specific header; replace HEADER_NAME with the actual header name

Attachments

VariableDescription
{message:attachments:count}Number of attachments
{message:attachments:size}Total attachment size in kilobytes (default unit)
{message:attachments:size:b}Total attachment size in bytes
{message:attachments:size:kb}Total attachment size in kilobytes
{message:attachments:size:mb}Total attachment size in megabytes
{message:attachments:size:gb}Total attachment size in gigabytes
{message:attachments:filenames}Comma-separated list of attachment filenames
{message:attachments:filenames_perline:PREFIX}Attachment filenames on separate lines, each prefixed with PREFIX

Misc

VariableDescription
{misc:guid}Randomly generated GUID in the format 00000000-0000-0000-0000-000000000000
{misc:random:MIN-MAX}Random integer between MIN and MAX (inclusive)
{misc:random:value1,value2,value3}Random value selected from a comma-separated list
{misc:date:FORMAT}Current date and time formatted using Java date pattern characters (y, M, d, H, m, s, etc.)