Metadata Tokens in the Web-based Publisher in Backlight 4
Metadata Tokens are used to define the display of image metadata within albums. These may be used in designated places within album templates.
Our Web-based Publisher in Backlight 4 supports all of the tokens defined on this page. See Metadata Tokens in Lightroom's Publish Services Publisher for information on supported tokens in Lightroom. See Metadata Tokens in Backlight 2 and 3 for information on supported tokens in Backlight 2 and 3.
Tokens are set using curly brackets. For example:
{Title} shot with exposure {Exposure} on {D1}.
After changing metadata settings in a template, metadata will automatically be updated for photos the next time an album is viewed. There is no need to re-upload images in the web-based publisher.
The following metadata tokens are currently supported by our web-based Publisher:
Photo Date
| Token | Description |
|---|---|
| YYYY | The year the photo was taken, as a four-digit string |
| YY | The year the photo was taken, as a two-digit string |
| MM | The month the photo was taken, as a two-digit string |
| DD | The day of the month the photo was taken, as a two-digit string |
| HH | The hour value for the time the photo was taken, in 24-hour notation, as a two-digit string |
| MIN | The minute value for the time the photo was taken, as a two-digit string |
| SS | The seconds value for the time the photo was taken, as a two-digit string |
| Mon | The month the photo was taken, as a localized three-character string |
| Month | The month the photo was taken, as a localized string |
| Date | The day of the month the photo was taken, as one- or two-digit string |
| D1 | The full date of the photo, in the system-localized short format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "2010-03-24". |
| D2 | The full date of the photo, in the system-localized medium format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "Mar 24, 2010". |
| D3 | The full date of the photo, in the system-localized long format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "March 24, 2010". |
| T1 | The full time-of-day of the photo, in the system-localized short format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "3:38 PM". |
| T2 | The full time-of-day of the photo, in the system-localized long format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "3:38:02 PM". |
Current Date
| Token | Description |
|---|---|
| yyyy | The current year as a four-digit string |
| yy | The current year as a two-digit string |
| mm | The current month as a two-digit string |
| dd | The current day of the month as a two-digit string |
| hh | The current hour value, as a two-digit string |
| min | The current minute value, as a two-digit string |
| ss | The current seconds value, as a two-digit string |
| mon | The current month, as a localized three-character string |
| month | The current month, as a localized string |
| date | The current day of the month, as one- or two-digit string |
| d1 | The current full date, in the system-localized short format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "2010-03-23". |
| d2 | The current full date, in the system-localized medium format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "Mar 23, 2010". |
| d3 | The current full date, in the system-localized long format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "March 23, 2010". |
| t1 | The current full time-of-day, in the system-localized short format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "3:38 PM". |
| t2 | The current full time-of-day, in the system-localized long format that you can set in your operating system's preferences dialog. On my system this is something along the lines of "3:38:02 PM". |
File Names and Paths
| Token | Description |
|---|---|
| Filename | The filename – without path and without extension – of the exported copy |
| FILENAME | Like Filename, but includes the extension |
| NumericFilenameSuffix | The numeric portion of the exported filename, without leading zeros. For example Image-012.jpg would return 12 |
| NUMERICFILENAMESUFFIX | The numeric portion of the exported filename, with leading zeros. For example Image-012.jpg would return 012 |
Image
| Token | Description |
|---|---|
| Filetype | One of: "JPEG", "RAW", "PNG", "GIF", "DNG", "TIFF", "PSD", "Video" and "Unknown" |
| OriginalWidth | The width of the (possibly pre-crop) original master image (not the exported one), in pixels |
| OriginalHeight | The height of the (possibly pre-crop) original master image (not the exported one), in pixels |
| CroppedWidth | The width of the (possibly post-crop) library image (not the exported one), in pixels |
| CroppedHeight | The height of the (possibly post-crop) library image (not the exported one), in pixels |
| AspectRatio | This becomes "Portrait" if the cropped image is more tall than wide, "Square" if the cropped with and height are the same, and "Landscape" if wider than tall. |
Lens / Camera / Exposure
| Token | Description |
|---|---|
| Aperture | The photo's aperture value, formatted like "f/4.5" |
| CameraMake | The photo's "Camera Make". |
| CameraModel | The photo's "Camera Model". |
| Exposure | The photo's exposure data, like "¹⁄₂₅₀ sec at f/5.0". |
| Flash | One of "no flash", "flash fired", or "unknown flash". |
| FocalLength | Focal Length, as a number |
| FocalLengthMM | Focal Length (with "mm" appended) |
| ISO | The photo's ISO (sensor sensitivity) number. |
| Lens | The photo's lens information, like "24-70mm f/2.8". |
| ShutterSpeed | The shutter speed, formatted like "¹⁄₂₅₀ sec". |
Location
| Token | Description |
|---|---|
| GPSCoordinates | The photo's geoencoded coordinates, like "35°1'11.51" N 135°46'16.05" E" |
| Altitude | The photo's geoencoded altitude, as a number, in meters. |
| GPSAltitude | The photo's geoencoded as a description, e.g. "27.3 m" |
| Latitude | Latitude, as a floating-point number. |
| Longitude | Longitude, as a floating-point number. |
| Location | The "Location" metadata item |
| City | The "City" metadata item |
| State | The "State" metadata item |
| Province | The "State" metadata item |
| Country | The "Country" metadata item |
| CountryCode | The photo's "ISO Country Code". |
Other Metadata
| Token | Description |
|---|---|
| Artist | The "Contact > Creator" |
| Creator | The "Contact > Creator" |
| Caption | The "Caption" metadata string |
| Category | The photo's "IPTC > Category". |
| Copyright | The "Copyright" metadata item |
| CopyrightUrl | The "Copyright Info URL" metadata item |
| WebStatementOfRights | The "Copyright Info URL" metadata item |
| CreditLine | The "Workflow > Credit Line" |
| Keywords | The list of the photo's marked-for-export keywords, separated by commas. (Actually, there's a comma+space pair between each keyword, so it's "plant, rose, flower" and not "plant,rose,flower".) |
| Title | The "Title" metadata item |
TTG Publisher Exclusive
These tokens are original additions to TTG Publisher, and will not cross over to Jeffrey's export plugins.
| Token | Description |
|---|---|
| CellNumber | Outputs the sequential number of the image in the gallery. The first image is 1, the second image is 2, etc. |
| NumImages | Outputs the total number of images in the gallery. |
Examples
date: Mon={Mon}, Month={Month}, Date={Date} => date: Mon=Jan, Month=January, Date=20
date: HH={HH}, MIN={MIN}, SS={SS} => date: HH=21, MIN=42, SS=34
date: D1={D1}, D2={D2}, D3={D3} => date: D1=2018-01-20, D2=Jan 20, 2018, D3=January 20, 2018
date: {YY}/{MM}/{DD} {T1} => date: 18/01/20 9:42 PM
date: {YYYY}/{MM}/{DD} {T2} => date: 2018/01/20 9:42:34 PM
The shutter speed: {ShutterSpeed}, the aperture: {Aperture}, the flash: {Flash}, date: {YY}/{MM}/{DD} {T2} => The shutter speed: 1/250, the aperture: 4, the flash: unknown flash, date: 18/01/20 9:42:34 PM
The category: {Category}, The filename: {Filename}, the label: {Label}, the latitude: {Latitude}, the longitude: {Longitude} => The category: , The filename: , the label: , the latitude: , the longitude:
A walk {Title:LC} in the {Caption:UC|Title:LC|"Boo"} with another {Title} => A walk in the MODEL EUNJEONG KANG, MAKE-UP ARTIST DOT MOORE , CLOTHING FRECKLESEOUL with another
The title {Title}, the {Missing|"Default"} and the {Title|"Wardrobe"} => The title , the Default and the Wardrobe
A passthru for {CellNumber} and {NumImages} => A passthru for {CellNumber} and {NumImages}