Approve and reject MatchID matches

How to Set Roster Matching on a Gallery

1. 1

   Open the Gallery Browser

   Navigate to the Gallery Browser page and find your gallery.
2. 2

   Open gallery settings

   Right-click the gallery card or click the ⋯ menu, then select "Edit".
3. 3

   Set the roster matching teams

   In the gallery edit form, find the "Roster Matching" section. Select a category (e.g., "Cal Athletics", "Riverside Athletics") on the left, then check the specific teams on the right. You can select teams from multiple categories.
4. 4

   Save

   The scope takes effect immediately. From now on, person search and face processing in this gallery will be limited to athletes on those teams.

How Roster Matching Works

• •Gallery stores face_scope_subcategory_ids, an array of team IDs selected in Roster Matching
• •Categories organize athletes into groups (e.g., "Cal Athletics") with subcategories for teams (e.g., "Football", "Basketball")
• •Person search defaults to athletes from the teams selected in Roster Matching
• •Results are filtered to only athletes on the selected teams
• •Typing a jersey number like "10" returns only #10 athletes on those teams
• •Toggle to "All Indexed" to expand search to your full athlete database
• •Without a scope set, person search returns no results, toggle to "All Indexed" or set a roster scope

Who can approve and reject

The approve and reject controls appear only for people whose access to the folder or gallery includes the Edit Tags capability. Tagger, Photographer, Editor and Folder Admin grants include it; Viewer, Downloader and Contributor grants do not. A photographer also has full control of any gallery they are photographer of record on. If you can open a gallery but the controls are missing, ask your organization admin to change your role on that folder under Users → Folder Access. The account type shown on the Users list is not what decides this.

What you see, and what you don't

A pending match is a name beside the detected face, nothing more. GalleryID does not show a confidence score or percentage for a match, by design: the decision is yours, or it was made by the auto-approve level your organization set. A match that cleared that level is already written and carries an Autobadge. One that did not waits for you with a Review badge.

Match Status

Reviewwaiting for a decision

Autocleared the confidence bar

Confirmeda reviewer approved it

XMPcame in with the file

Jerseynumber read, no usable face

Approve & Reject

Each pending match appears as a compact two-line row. The first line shows a source badge and the person's name with approve/reject buttons. The second line (when available) shows position, jersey number, team. Click the green checkmark to approve or the red X to reject.

• •Approving adds the person to the photo's XMP tags (xmp_persons)
• •Rejecting removes the match, the person won't be associated with that photo
• •Approved matches move to the Tagged People section as unified tag rows

Taking a whole photo at once

When a photo has several pending matches, two links appear beside the pending count: Approve all and Reject all. They act on every pending match on the current photo, and the keyboard does the same thing.

Jersey-Only Matches

Some matches are based solely on jersey number detection (OCR), not face similarity. These appear with distinct visual styling so you can tell them apart from real MatchID matches:

How to Add a Reference Photo

1. 1

   Find a good photo

   Look for photos where the athlete's face is clearly visible. Sideline shots, celebration moments, and pre-game warmups work well.
2. 2

   Click "+ Add as Reference Photo"

   Below the tag input on each photo card, click the link. This opens the reference modal.
3. 3

   Select a face

   If the photo has multiple detected faces, choose which face to use. Jersey-only detections are automatically filtered out since they don't have usable face data.
4. 4

   Assign to a person

   Search by name or jersey number. The system suggests people already tagged in the photo. Select the person this reference should be linked to.
5. 5

   Choose a photo type

   Classify the reference, Action, Helmet On, Sideline, Sunglasses, Headshot, or Other. This helps the system understand what kind of variation this reference adds.
6. 6

   Click "Add Reference"

   The photo is saved as a reference and sent to the AI for embedding. Future gallery processing will use this reference for matching.

Reference Photo Indicators

Use as referencethis frame can become a reference

Reference photoalready one of this person’s references

Photos that have been used as reference photos are visually marked in the review grid:

Best Practices for Gallery References

• •Sideline and warmup shots make the best references, clear faces, good lighting, natural angles
• •Helmet-on references noticeably improve football matching (a face that barely registers bare-headed can clear the bar with a helmet reference)
• •Don't reference motion-blurred photos, if you can't see the face clearly, the AI can't either
• •Adding 2–3 diverse references per athlete is usually enough to cover most conditions
• •References are indexed automatically, the status updates from Pending to Indexed shortly after

Searching People

• •Type a name, searches full_name with fuzzy matching (e.g., "Mar" finds "Marcus Rivera")
• •Type a number, auto-detects and searches jersey number with prefix match (e.g., "1" finds #1, #14, #10)
• •Results show headshot thumbnail, name, jersey number, position, and team name
• •Each result shows an "Indexed" (green) badge for athletes with indexed headshots
• •Dropdown defaults to the gallery's roster matching teams ("Gallery Roster" mode)
• •Toggle to "All Indexed" above the search input to search your full athlete database

Two Types of Tags

Tag Rows

Each tag on a photo shows where it came from. The thumbnail badge tells you at a glance; see Match Status above for the full set.

All tags, whether from AI, auto-approval, XMP metadata, or manual entry, display as unified two-line rows. Each row has a colored source badge, the person's name, and a hover-to-show remove button. When detail data is available, a second line shows position, jersey number and team.

Removing Tags

Hover over any tag row to reveal the × button on the right side. Clicking it removes the name from xmp_persons and, if there's an associated MatchID match, rejects that match.

Refresh Button

The circular-arrows icon in the review toolbar reloads the current gallery's data from the database without a full page reload. Use it after making changes outside the review page (e.g., uploading new photos, running facial recognition) to see updated results without navigating away.

Auto-Refresh on Modal Close

When you close the review modal after approving, rejecting, or tagging, the gallery data automatically refreshes. This ensures filters, match counts, and person badges are immediately up to date without needing to manually reload.

Filtered Photo Navigation

When you filter photos by person name and then open the review modal, navigation only cycles through the filtered set. For example, filtering to "Jamie" showing 8 photos means the modal shows "1 of 8" and only navigates those 8, not the full gallery.