Tokens
Tokens can be used in filenames, captions, email subject and body, SMS messages, QR code text, and other fields to insert dynamic values at runtime.
Date and Time Tokens
Use % tokens to insert the date and time the photo was taken. Use {bracket} tokens to insert the current clock time when the token is evaluated.
| Token | Description | Example |
|---|---|---|
%a |
Abbreviated weekday | Fri |
%A |
Full weekday | Friday |
%b |
Abbreviated month | Jun |
%B |
Full month name | June |
%d |
Date as YYMMDD | 110617 |
%D |
Day of month (01–31) | 06 |
%H |
Hour (00–23) | 20 |
%I |
Hour (01–12) | 08 |
%m |
Month (01–12) | 06 |
%M |
Minutes (00–59) | 23 |
%S |
Seconds (00–59) | 45 |
%t |
Time as HHMMSS | 202345 |
%y |
Year without century | 17 |
%Y |
Year with century | 2017 |
%l |
Long date and time | Monday, January 17, 2017 19:03:47 |
%L |
Long date | Monday, January 17, 2017 |
{timeNow} |
Current time as HHMMSS | |
{yearNow} |
Current year YYYY | |
{monthNow} |
Current month (01–12) | |
{dayNow} |
Current day (01–31) | |
{yearLess8h} |
Year, 8 hours ago | For events continuing past midnight |
{monthLess8h} |
Month, 8 hours ago | |
{dayLess8h} |
Day, 8 hours ago | |
{dateLess8h} |
Date less 8h as YYYY-MM-DD | 2018-01-21 |
{time,<datetime>} |
Returns 0 if before {<datetime>}, 1 if after |
{if,{time,1159},afternoon,morning} |
Folder Tokens
These tokens resolve to standard system folder paths on the current user’s computer. Use them to build file paths dynamically without hardcoding locations.
| Token | Description |
|---|---|
{documents} |
Current user’s Documents folder |
{desktop} |
Current user’s Desktop folder |
{profile} |
Current user’s profile folder |
Shooting Data Tokens
These tokens pull metadata directly from the camera at the moment of capture. Use them to embed technical details like ISO, aperture, or camera model into filenames or captions.
| Token | Description |
|---|---|
%c |
Camera serial number (Canon EOS only) |
%i or {iso} |
ISO value |
{tv} |
Shutter speed (1/ removed, e.g. 125 for 1/125s) |
{av} |
Aperture setting |
{orientation} |
L (landscape) or P (portrait) |
%T or %v |
Camera model (from first word containing digits) |
%T2 or %V |
Full camera model name |
%o |
Image filename without extension |
String Manipulation Tokens
These tokens let you extract, transform, or combine text from other token values. They can be nested inside other tokens to build complex dynamic strings.
| Token | Description | Example |
|---|---|---|
{left,n,str} |
First n characters of str | {left,4,{filename}} |
{mid,n,m,str} |
m characters from position n | {mid,1,3,{filename}} |
{right,n,str} |
Last n characters of str | {right,2,{filename}} |
{field,n,str} |
nth field (split by space, period, hyphen, slash, backslash, underscore) | {field,2,{filename}} |
{field2,n,ch,str} |
nth field using character ch as separator | {field2,2,-,one-two-three} → two |
{first,str} |
First word of str | {first,%L} |
{last,str} |
Last word of str | {last,%L} |
{upper,str} |
Convert to upper case | {upper,%B} → JUNE |
{lower,str} |
Convert to lower case | {lower,%B} → june |
{capitalize,str} |
Lower case with first letter capitalised | {capitalize,john} → John |
{default,str1,str2} |
Returns str1 unless empty, then str2 | |
{if,test,str1,str2} |
Returns str1 if test is non-zero/non-empty, else str2 | |
{compare,str1,str2} |
Returns 1 if str1 equals str2 | |
{lessThan,str1,str2} |
Returns 1 if str1 < str2 (numeric or alphabetical) | |
{contains,str1,str2} |
Returns 1 if str1 contains str2 | |
{random,n,m} |
Random number between n and m (reset at each ready screen) | |
{urlencode,str} |
Percent-encodes str for use in a URL | |
{tinyUrl,url} |
Shortens a URL using tinyurl.com |
Photo Booth Tokens
These tokens provide information specific to the current photo booth session, such as shot count, sequence timing, and file references. Use them to track and label individual shots within a sequence.
| Token | Description |
|---|---|
{photoboothNumImages} |
Number of shots in the sequence |
{photoboothImage} |
Current shot number in the sequence |
{photoboothDateTime} |
Date and time at sequence start (YYYYMMDD_HHMMSS) |
{photoboothDate} |
Date at sequence start |
{photoboothTime} |
Time at sequence start |
{photoboothDir} |
Full path to photo booth images folder |
{photoboothSubdir} |
Subfolder name only |
{photo1}, {photo2} etc. |
Filename (no extension or path) of each photo |
{filename} |
Filename of saved print layout |
{filenameNoExt} |
Filename without extension |
{uid} |
Unique ID (ABC12345 format), updated each session |
{uid2} |
Alternative unique ID (ABCDE123 format) |
{uid3} |
Alternative unique ID (ABC123DEF format) |
{guid} |
128-bit globally unique ID |
{imageCounter} |
Total shutter activations |
{imageCounter5} |
Same, zero-padded to 5 digits |
{imageCounter6} |
Same, zero-padded to 6 digits |
{isGif} |
1 if file is animated GIF (sharing only) |
{isJpeg} |
1 if file is JPEG (sharing only) |
{isMovie} |
1 if file is movie (sharing only) |
Event and User Tokens
These tokens carry information configured for the current event, along with data entered by guests during the session. Use them to personalise output with event details, guest input, or survey responses.
| Token | Description |
|---|---|
{eventName} |
Event name |
{eventDate} |
Event date (YYYY-MM-DD) |
{eventId} |
MD5 of event name + date |
{eventString1} – {eventString5} |
Additional event strings |
{eventPrintCounter} |
Shared print counter (decremented per print) |
{eventPrintTotal} |
Shared print total (incremented per print) |
{localPrintCounter} |
Remote Pro-only print counter |
{printQuotaUsed} |
1 when print counter reaches 0 |
{printTemplateName} |
Filename of last loaded print template |
{eventKiteGalleryId} |
EventKite gallery ID |
{eventKiteSessionId} |
EventKite session ID |
{qr1} – {qr10} |
Strings scanned from QR codes |
{message} |
Message entered at end of sequence keyboard |
{sharingMessage} |
Optional message entered when sending email |
{user1_data}, {user2_data} etc. |
Text from touchscreen keyboard prompts |
{survey1_text1} etc. |
Text from survey screen text fields |
{survey1_chkbox1} etc. |
Checkbox values from survey screens (0 or 1) |
Email Attachment Tokens
Use these tokens inside an HTML email template to embed images captured during the session. They reference attached files by type or position in the email.
| Token | Description |
|---|---|
{print_layout} |
JPEG copy of print layout |
{photo1}, {photo2} etc. |
Original individual photos |
{thumbnail1}, {thumbnail2} etc. |
Thumbnail images |
{processed1}, {processed2} etc. |
Processed photos |
{gif} |
Slideshow or boomerang GIF |
{video_preview} |
JPEG preview of video |
{image} or {image1} |
First email attachment |
{image2}, {image3} etc. |
Subsequent attachments |
{to} |
To email address or phone number (email/text body only) |