Overview

Assign yearbook portraits to classmate records. Matched portraits appear on each classmate's profile page.

Where Photos Come From

Upload portraits here using Add Portraits. Files are staged in storage and persist across sessions until assigned. The Scan Processor is a separate workflow — it uploads approved portraits directly to classmate records and never writes to this staging queue.

How to Match a Portrait

1. Click a portrait in the left grid to select it.
2. Search the classmate's name in the right panel.
3. Click their name in the results list.
4. Click Assign to save the match.

Keyboard Shortcuts

← →

Navigate to the previous or next portrait.

Enter

Assign the currently selected classmate.

Classmates Without a Photo

The collapsible panel at the top of the page shows everyone who still needs a portrait assigned.

Tips

• Name files Lastname_Firstname.png before uploading for automatic matching.
• Use Skip to pass over a portrait without assigning it.
• You can upload individual portraits directly here for one-off additions.

What this tool does

Upload yearbook page scans, draw or auto-detect crop boxes, review the results, then route photos to the right destination based on what they are.

Three job modes

Portrait page

Rows of individual headshots. Auto-detect works well. Approve each crop to upload directly to the classmate's record, or use Save to DB to bulk-save all approved matches at once.

Group / Team page

Sports teams, clubs, class photos. Auto-detect finds larger regions. After review, use Publish to Gallery → photos appear in the Yearbook Gallery.

Manual

Draw all boxes yourself. Good for mixed pages, teacher/staff photos, or anything auto-detect misses. Use Publish to Gallery for the destination.

Workflow at a glance

1. Click + New Job, choose mode, set a label, upload or pick a scan.
2. In the editor: click Auto-detect to find boxes, or draw them manually.
3. Drag boxes to reposition, drag handles to resize. Click Auto-order to renumber left-to-right, top-to-bottom.
4. Click Crop All → to enter Review mode.
5. In review: enter a name/caption for each crop, click Approve on the ones you want to keep.
6. Click Save to DB (portrait) or Publish to Gallery (everything else).

Keyboard shortcuts

Tips

• Adjust the Sensitivity slider if auto-detect misses boxes or picks up too much noise — lower values detect lighter backgrounds.
• Use Save Progress frequently. Jobs persist across sessions so you can stop and resume.
• The Delete button on a job card permanently removes it. Use Delete scan too to also free storage space.
• Export ZIP downloads all non-skipped crops as PNGs — useful for offline archiving regardless of mode.