Start here
Your first game, start to finish
The whole workflow in order, from an empty library to named files you can search. Each step is short and links to the article with the details.
Roster or headshots
MatchID finds the athlete. CaptionID names them. They’re two different things, and most folders use both.
| Roster (CaptionID) | Headshots (MatchID) | |
|---|---|---|
| What it is | A list of names with shortcodes, built from the Roster Feed or imported from a spreadsheet. | Reference headshots you index, one card per person. |
| Where it lives | Rosters (⌥⌘4), or Codes in Browse. | MatchID People (⌥⌘3). |
| What it does | You type a shortcode, a number or a name, and CaptionID writes the name and the caption line. | MatchID finds the faces it knows and names them for you to confirm. |
| What it needs | Nothing else. It works on its own. | Indexed headshots. A roster alone can't match a face. |
Before the season
Once per season, or once per team.
- 1
Set the Default template
Settings (⌘,) ▸ MatchID Metadata ▸ Edit default template… Put{person_name}, or a long form that carries the number, in the fields you want filled, such as Persons Shown and the caption. Any folder without a template of its own uses it. - 2
Build the roster
Rosters ▸ + New Roster picks a league and teams from the Roster Feed. Import roster… brings in a spreadsheet instead. - 3
Index headshots, for MatchID
In MatchID People, make a category for the school and a subcategory for the team, drop the headshots in, check the names and numbers, and index. Media day headshots are ideal. - 4
Leave the MatchID settings alone, for now
The defaults are calibrated for team sports. Change one when Review gives you a reason to.

More: MatchID settings and template · Set a roster on a folder · Index reference headshots
Bring the game in
From the card
- 1
Open Ingest
Press ⌘G, or plug in a card and the dialog opens on it. - 2
Set the rows
Roster: the game’s roster. MatchID ▸ Choose…: the teams on the field. XMP: your template. - 3
Copy
The new folder arrives with its roster and teams already set, ready to tag.

Already on your drive
Open the folder in Browse. Codes sets the roster. MatchID sets the teams and runs it, which is the next step.

More: Ingest from a card · Browse your photos
Run MatchID
- 1
Click MatchID in Browse
The window holds the folder’s teams and common codes. - 2
Tick the teams
At least one team, not just the school. One team beats the whole library, for speed and for accuracy. - 3
Save & process
It reads the whole folder, or only the photos you selected. When it finishes you land in Review, or a toast offers it.
Faces and jersey numbers are read in the same run. There’s no second pass.
More: Tag photos with MatchID · Tag photos in the photo window
Review and tag

- 1
Start with Review
Approve (✓, or A for the whole photo) or reject (✕, or R) each card. On a Review or JERSEY card, check the number against the jersey. - 2
Tag who it missed
Type in the tag box under the photo (⌘K): a shortcode, a number or a name from the roster. - 3
Clear No Tags
No one in these frames is named yet, usually because no face is showing. Select a run of them in Browse, press ⌘T, search by jersey number, and click Apply. - 4
Move on
Next → (⌘N) or → saves the photo and opens the next one.


When names are written
| What you did | When it's written to the file |
|---|---|
| MatchID auto-approved it | When the run finishes. |
| Approved or tagged it in Review or the photo window | When you press Save, Next or Back, or go to another photo with the arrow keys. |
| Tagged it with Tag people (⌘T) | When you click Apply. |
| Closed the window (Esc) before saving | Not yet. It asks before throwing the changes away. |
Names write to the file in XMP and IPTC metadata, with a sidecar for RAW. Photo Mechanic, Lightroom and Capture One read them, so the names go wherever the file goes.
Send it
| From Browse | What it does |
|---|---|
| FTP (⌘U) | Sends the selected photos to a saved FTP, FTPS or SFTP destination, resized and watermarked if you want. |
| ZIP (⌘⇧U) or Export | Writes copies to a ZIP or a folder, with your size, sharpening and watermark. |
| Send to Cloud | Uploads the selected photos to a GalleryID Cloud gallery. Cloud is a separate subscription, and Desktop doesn't need it. |
More: Send named files over FTP · Export, watermark and sharpen · Send photos to GalleryID Cloud
Find it later
| To find | Use |
|---|---|
| An athlete, across your folders | ⌘F Search. Type a name and it looks through Persons Shown, keywords, title, headline and caption. |
| A jersey number | The same Search, when the number is in the caption. A long form like “Marcus Cole #12 of State” makes #12 searchable. |
| Something in this folder | ⌥⌘F Find narrows the grid by filename or any metadata field. |
| Photos on an unplugged drive | Catalog. Catalog the drive once, then browse and search it with the drive disconnected. |
More: Browse your photos · Browse an unplugged drive with Catalog