Skip to main content

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#

TokenDescription
YYYYThe year the photo was taken, as a four-digit string
YYThe year the photo was taken, as a two-digit string
MMThe month the photo was taken, as a two-digit string
DDThe day of the month the photo was taken, as a two-digit string
HHThe hour value for the time the photo was taken, in 24-hour notation, as a two-digit string
MINThe minute value for the time the photo was taken, as a two-digit string
SSThe seconds value for the time the photo was taken, as a two-digit string
MonThe month the photo was taken, as a localized three-character string
MonthThe month the photo was taken, as a localized string
DateThe day of the month the photo was taken, as one- or two-digit string
D1The 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".
D2The 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".
D3The 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".
T1The 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".
T2The 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#

TokenDescription
yyyyThe current year as a four-digit string
yyThe current year as a two-digit string
mmThe current month as a two-digit string
ddThe current day of the month as a two-digit string
hhThe current hour value, as a two-digit string
minThe current minute value, as a two-digit string
ssThe current seconds value, as a two-digit string
monThe current month, as a localized three-character string
monthThe current month, as a localized string
dateThe current day of the month, as one- or two-digit string
d1The 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".
d2The 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".
d3The 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".
t1The 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".
t2The 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#

TokenDescription
FilenameThe filename โ€“ without path and without extension โ€“ of the exported copy
FILENAMELike Filename, but includes the extension
NumericFilenameSuffixThe numeric portion of the exported filename, without leading zeros. For example Image-012.jpg would return 12
NUMERICFILENAMESUFFIXThe numeric portion of the exported filename, with leading zeros. For example Image-012.jpg would return 012

Image#

TokenDescription
FiletypeOne of: "JPEG", "RAW", "PNG", "GIF", "DNG", "TIFF", "PSD", "Video" and "Unknown"
OriginalWidthThe width of the (possibly pre-crop) original master image (not the exported one), in pixels
OriginalHeightThe height of the (possibly pre-crop) original master image (not the exported one), in pixels
CroppedWidthThe width of the (possibly post-crop) library image (not the exported one), in pixels
CroppedHeightThe height of the (possibly post-crop) library image (not the exported one), in pixels
AspectRatioThis 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#

TokenDescription
ApertureThe photo's aperture value, formatted like "f/4.5"
CameraMakeThe photo's "Camera Make".
CameraModelThe photo's "Camera Model".
ExposureThe photo's exposure data, like "ยนโ„โ‚‚โ‚…โ‚€ sec at f/5.0".
FlashOne of "no flash", "flash fired", or "unknown flash".
FocalLengthFocal Length, as a number
FocalLengthMMFocal Length (with "mm" appended)
ISOThe photo's ISO (sensor sensitivity) number.
LensThe photo's lens information, like "24-70mm f/2.8".
ShutterSpeedThe shutter speed, formatted like "ยนโ„โ‚‚โ‚…โ‚€ sec".

Location#

TokenDescription
GPSCoordinatesThe photo's geoencoded coordinates, like "35ยฐ1'11.51" N 135ยฐ46'16.05" E"
AltitudeThe photo's geoencoded altitude, as a number, in meters.
GPSAltitudeThe photo's geoencoded as a description, e.g. "27.3 m"
LatitudeLatitude, as a floating-point number.
LongitudeLongitude, as a floating-point number.
LocationThe "Location" metadata item
CityThe "City" metadata item
StateThe "State" metadata item
ProvinceThe "State" metadata item
CountryThe "Country" metadata item
CountryCodeThe photo's "ISO Country Code".

Other Metadata#

TokenDescription
ArtistThe "Contact > Creator"
CreatorThe "Contact > Creator"
CaptionThe "Caption" metadata string
CategoryThe photo's "IPTC > Category".
CopyrightThe "Copyright" metadata item
CopyrightUrlThe "Copyright Info URL" metadata item
WebStatementOfRightsThe "Copyright Info URL" metadata item
CreditLineThe "Workflow > Credit Line"
KeywordsThe 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".)
TitleThe "Title" metadata item

TTG Publisher Exclusive#

These tokens are original additions to TTG Publisher, and will not cross over to Jeffrey's export plugins.

TokenDescription
CellNumberOutputs the sequential number of the image in the gallery. The first image is 1, the second image is 2, etc.
NumImagesOutputs 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}