Docs › Guides › Add a reference photo

How to add a reference photo

The reference photo is the enrollment template against which the signer's live face is compared. Pick the right one and verification succeeds smoothly. Pick the wrong one and the signer fails verification — even if they are the right person.

What the reference photo is used for

Before the signing ceremony begins, District Seal computes an ArcFace embedding from the reference photo. That 512-dimensional vector is stored and becomes the ground truth. When the signer completes the ceremony, the server computes an embedding of their live face from the recorded video and compares the two. If the cosine distance between them is below the configured threshold (default 0.55), the identity check passes.

The reference photo is not shown to the signer. It is only used by the server for the face-match comparison, and it is stored alongside the certificate in your dashboard records.

What makes a good reference photo

Face clearly visible

Good lighting

Neutral expression

Recent photo

Plain background

What to avoid

AvoidWhy
Group photosMultiple faces confuse the detector. Crop to one face.
Side profilesArcFace is best at frontal faces. A 3/4 or profile shot will produce a very different embedding.
Old photos with different hairstyle or weightEmbeddings shift with significant appearance changes.
Heavily filtered photosBeauty filters change face geometry and reduce match accuracy.
Photos with another person's face at any scaleEven a small face in the corner can confuse detection.
Screenshots from social mediaOften compressed and resized; may have watermarks or text.
Low-resolution or blurry imagesDetector needs enough pixel detail to localize landmarks.

Technical requirements

PropertyRequirement
File formatJPEG, PNG
File sizeUnder 10 MB
Minimum resolution400 × 400 px recommended (higher is better)
Face proportionFace should occupy roughly 30–60% of the frame

How to crop a good reference photo

  1. Open the photo in any image editor (Preview, Photos, Photoshop, GIMP).
  2. Crop so the face is centered and takes up most of the frame, with a small margin around the head.
  3. Do not enlarge or stretch — crop, don't resize.
  4. Save as JPEG at high quality.
  5. Upload to the Reference photo drop zone in the New Request view.

Why the reference photo matters for legal defensibility

The reference photo is the anchor of the identity verification. If a signature is later disputed, the certificate and the forensic record show that the person who signed matched this specific reference photo, within this specific threshold, at this specific time. An ambiguous reference photo — a group photo, a blurry shot, a heavily filtered image — weakens the chain of evidence. A clear, recent, front-facing photo strengthens it.

Troubleshooting

ProblemFix
Signer fails face match even though it's the right personReference photo is likely outdated or taken at an angle. Use a recent, front-facing photo.
"No face detected" error on uploadThe detector could not find a clear face. Crop tighter, improve lighting, remove other faces.
Distance came back close to the threshold (0.50–0.55)Borderline. If the signer can retry with better lighting it may pass. If it fails consistently, replace the reference photo.

District Seal is a product of NEXSIM LLC, Montana, United States.

Support: support@districtseal.com

Back to documentation