Tokens in Capture One are represented by a grey box surrounding white text. These variables are dynamically updated by Capture One and allow for reduced user input in critical areas such as:
- the Naming tool in the Import dialog
- in the Batch Rename tool
- the Output Naming tool in the Output tool tab
- the Output Location tool in the Output tool tab
- in the Naming tool of the Export dialogue 14.3.0 and forward
- the Format field of the Watermark tool (when the Text option is chosen)
- the Next Capture Naming tool in the Capture tool tab
Let's break down this example:
- The [Destination Folder Name] token will pass the current capture folder's name.
- The static text underscore ("_") is not a token and will stay present.
- The [4 Digit Counter] token will pass the capture counter as a 4 digit number, incrementing with each new capture.
Tokens and their respective values
There are many tokens available in Capture One. Most are available in all areas where Tokens are applicable, however, some might be not applicable. For example, [Destination Folder Name] is not available in a Batch Rename since that function has nothing to do with the capture folder.
Some tokens have close syntax alternatives, which can be accessed by clicking the arrow to the right of the text in the token. For example, the [3 Digit Counter] allows different digit counts, while the date-associated tokens have alternative formats.
NOTE: With the release of Capture One 21 (14.3.0) the tokens Sub Name and Job Name have been removed, as export location and naming are now recipe specific. You can use free text in the Format field.
Job name token is added again in Capture One 21 (14.4.0). This token can be used in Export Naming and enables a shared naming section between recipes.
Read more about the Exporter in this article.
Here is a breakdown of each Token available and the value it returns.
Token |
Value Returned | Import | Capture |
Output Naming |
Output Location |
Export | Rename | Watermark |
X Digit Counter | Sequential counter, padded with 0. There are five counters in a Capture One document: capture, import, rename, export, and output.To change the initial counter value, go to the main menu and select File -> [Counter] -> Set Counter. |
✓ |
✓ |
✓ |
|
✓ |
✓ |
✓ |
Address | Value from the IPTC Address field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Altitude | Value from the IPTC Altitude field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Aperture | Value from the EXIF Aperture field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Camera Counter | The counter value passed from the tethered camera |
✓ |
|
|||||
Camera Serial | Value from the EXIF Camera Serial field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Category | Value from the IPTC Category field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Clipboard Contents | The value stored in operating system's clipboard |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Collection Name | Library collection (Album, Smart Album, etc.) containing selected images |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Color Space | Color space of the source file (Adobe RGB (1998), sRGB, etc.) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Color Tag | Color tag of the variant |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Contact City | Value from the IPTC Contact City field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Contact Country | Value from the IPTC Contact Country field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Contact State | Value from the IPTC Contact State field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Copyright Notice | Value from the IPTC Copyright Notice field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Counter | Value from the IPTC Counter field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Creator | Value from the IPTC Creator field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Creator's Title | Value entered in IPTC Creator's Title field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Date (MM dd yyyy) | Current system date in the format: MM (month), dd (day), yyyy (year) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Day of Month (dd) | Current system day of the month |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Day of Week (EEE) | Current system day of week |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Month (MM) | Current system month |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Time (h-mm-a) | Current system time |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Current Year | Current system year |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Description | Value from the IPTC Description field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Description Writer | Value from the IPTC Description Writer field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Destination Folder Name | Name of the destination folder for the selected image(s) |
✓ |
✓ |
✓ |
|
✓ |
|
|
Dimensions | File dimensions of the source file |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Document Name | Value of current Capture One document name |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Drive Mode | Value from the EXIF Drive Mode field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Emails | Value from the IPTC Emails field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Exposure Compensation | Value from the IPTC Exposure Compensation field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Exposure Mode | Value from the IPTC Exposure Mode field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Exposure White Balance | Value from the IPTC Exposure White Balance field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Firmware | Firmware value of the file's camera |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Flash Compensation | EXIF Flash Compensation value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Flash Mode | EXIF Flash Mode value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Focal Length | EXIF focal length of lens value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Format | Format of the source file |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Headline | Value from the IPTC Headline field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Image City | Value from the IPTC Image City field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Image Country | Value from the IPTC Image Country field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Image Date (MMM dd yyyy) | EXIF capture date in the format: MMM (month), dd (day as number), yyyy ( |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Day of Month (dd) | EXIF capture date as dd (day as a number) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Day of Week (EEE) | EXIF capture day of the week as EEE (name of day) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Month (MM) | EXIF capture month as MM (month as a number) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Folder Name | Name of the folder on disk containing the source image file |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Parent Folder Name | Name of the parent folder on disk containing the source image file (available in Capture One Studio) |
✓ |
|
✓ |
✓ |
✓ |
✓ |
✓ |
Image Grandparent Folder Name | Name of the grand folder on disk containing the source image file (available in Capture One Studio) |
✓ |
|
✓ |
✓ |
✓ |
✓ |
✓ |
Image Name | The name of an image in its current state. E.g. When importing, this will be the original filename of the image. |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image State | Value from the IPTC Image State field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Image Time (h-mm a) | EXIF capture time as hour (h) minute (mm) and second (a) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Image Year (yy) | EXIF capture year as a number |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Instructions | Value from the IPTC Instructions field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Intellectual Genre | Value from the IPTC Intellectual Genre field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
ISO | EXIF ISO value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
ISO Country Code | Value from the IPTC ISO Country Code field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Job Identifier | Value from the IPTC Job Identifier field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Job Name | Value from the Job Name field in the Output Naming tool Token was removed only in Capture One 21 (14.3.0 and 14.3.1) and added again in Capture One 21 (14.4) in the Cross Recipe Tokens tool. |
✓ |
✓ |
|
✓ |
✓ |
|
|
Latitude | EXIF GPS latitude value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Lens | EXIF lens name value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Location | Value from the IPTC Location field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Longitude | EXIF GPS Longitude value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Make | EXIF make (manufacturer) of camera |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Metering Mode | EXIF metering mode of camera |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Model | EXIF model of camera |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Name | Value from the Name field in the Next Capture Naming tool |
✓ |
✓ |
|||||
Orientation | The orientation setting of the file |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Original Filename | Getty metadata field |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Owner | Value from the IPTC Owner field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Parent MEID | Value from the IPTC Parent MEID field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Personality | Value from the IPTC Personality field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Phones | Value from the IPTC Phones field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Postal Code | Value from the IPTC Postal Code field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Program | EXIF exposure program |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Provider | Value from the IPTC Provider field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Rating | EXIF rating value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Recipe Format | Value from the Format field of the Process Recipe tool |
|
|
✓ |
✓ |
✓ |
|
✓ |
Recipe Name | The name of the selected recipe in the Process Recipes tool |
|
|
✓ |
✓ |
|
✓ |
|
Rights Usage Terms | Value from the IPTC Rights Usage Terms field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Scene | Value from the IPTC Scene field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Sequence Count | EXIF Sequence Count count (support varies by manufacturer) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Sequence ID | EXIF Sequence ID count (support varies by manufacturer) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Sequence Total | EXIF Sequence Total count (support varies by manufacturer) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Sequence Type | EXIF Sequence Type count (support varies by manufacturer) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Session Sub Path | The path to the location on the local or external hard drive where the Session is located |
|
|
|
✓ |
|
|
|
Session Sun Path (Long) | The path to the location on the local or external hard drive where the Session is located |
|
|
|
✓ |
|
|
|
Shutter Speed | EXIF Shutter speed value |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Software | EXIF software creation tool. The name of the application that generated the file. |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Source | Value from the IPTC Source field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Subject Code | Value from the IPTC Subject Code field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Sub Name |
Value of the tool's Sub Name field Token removed starting from Capture One 21 (14.3.0) |
|
✓ |
✓ |
✓ |
|||
Supplemental Categories | Value from the IPTC Supplemental Categories field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Title | Value from the IPTC Title field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Variant Position | The variant position in a variant group as a number |
|
|
✓ |
✓ |
✓ |
✓ |
✓ |
Vendor White Balance | EXIF vendor's white balance description |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Websites | Value from the IPTC Websites field in the Metadata tool |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Comments
6 comments
Document Name is actually the session or catalog name.
I'm printing this out and hanging it near my desk for visual reference. I'm finally taking the time to set up my presets to help my work progress faster. Thanks!
@johan smith
In the coding of capture one, tho... capture one document in the code has historically = capture one session/cat. It's synonymous. But if you built integrations, you have to call out Capture Document to automate with sessions/cat.
How do I edit the Copyright token???
For what it's worth, X Digital Counter is NOT an option for Watermarks unless this is an update after Capture One 20 Pro.
Dear Lily,
thanks a lot for this feature. We would like to use the metadate token (e.g. "IPTC-description") for filling the watermark by text.
If the metadate field stays empty for some of our captures, the token delivers the text "No name" to the watermark modul, is this by purpose?
In our case the intended behaviour would be that for captures with empty metadate field the watermark text should also stay empty.
Is this possible?
Best, Christoph
P.S.: Trying to enter a white space in the metadate field is ignored.
Please sign in to leave a comment.