IPTC templates
Templates and tokens.
A template decides which fields get written, and a token decides what goes in them.
Tokens stay tokens in the template and only resolve when a person is tagged, so the same template works on the whole folder. Anything you type by hand around them is left alone. Two tokens placed side by side with nothing between them are treated as one choice: the first that has a value for that person wins, which is how a roster column and a MatchID long form can share a field. The files themselves only ever contain finished text, never a raw token.
Person tokens
Resolved for each person tagged on the photo.
{person_id}{person_name}{jersey_number}{category}{grade}{team}{position}{reference}{notes}Long-form tokens · MatchID
Wire-service caption styles, built from the indexed subject. Missing parts drop out cleanly.
{matchid_long1}{matchid_long2}{matchid_long3}{matchid_long4}Long-form tokens · roster file
The same four styles, built from a tagged roster row.
{long1}{long2}{long3}{long4}Raw roster columns
Whatever text sits in that column of the tagged row. Useful when a roster has its own column order and no header row.
{col_b}{col_c}{col_d}{col_e}{col_f}Photo tokens
Read from the file itself, so they are the same for anyone in it.
{filename}{filename_no_ext}{capture_date}{camera_serial}Job tokens
From the job the photos belong to.
{job_id}{job_name}{shoot_date}{shoot_date_iso}{organization}Assignment tokens
From the assignment attached to the job.
{event_id}{secondary_code}Edit
Edit metadata and captions
Fine-tune captions, keywords, and IPTC/EXIF on individual photos.
- From the grid, select a photo and press I or Space to edit that one photo. To apply a template across many, select them all and press ⌘I.Press and hold to enlarge
- The editor opens with IPTC fields on the left and the token rail on the right. Compact shows the fields you chose in Settings, and All + EXIF adds the full set with your own order kept at the top.Press and hold to enlarge