Enrolling a Member’s Face
Enrolment is a one-time, single front-face capture done on the Primary terminal. The device checks image quality and liveness, creates one FaceSDK template and retains a face-focused image for future recovery or migration. After the server confirms the upload, the member can clock in or out at any kiosk in the location, online or offline.
This is the page you should train your front-desk staff on most carefully, most “the app doesn’t recognise me” complaints trace back to a rushed enrolment.
Before you start
- You’re on the Primary terminal. Secondary terminals refuse to enrol; see Primary vs Secondary Terminals.
- The member exists in the dashboard. Add them at Members first if they don’t.
- Internet is connected. Capture, quality checks and liveness run on the device, but the face template and image must upload before enrolment is committed. No connection → enrolment cannot be completed.
- Lighting is good. Even, frontal light. Avoid backlight (no windows behind the member’s head) and harsh side shadows.
- The member is ready. No sunglasses, no hat brim shading the eyes, no mask. If they wear glasses every day, enrol them with the glasses on.
- Administrator-controlled enrolment. Facial enrolment is handled exclusively by an administrator. To begin, tap the three-dot overflow icon in the top-right corner of the Members screen.
The single capture, done right
The app asks for one FRONT capture. The member must look straight at the camera with a neutral, relaxed expression. Do not turn the head left or right; anything more than about 15° of head rotation may be rejected.
| Capture | Distance | Expression | What the member does |
|---|---|---|---|
| FRONT | ~50 cm (a comfortable arm’s length) | Neutral | Centres their face in the oval, looks straight at the camera and holds still. |
After Capture is tapped, keep looking forward and hold still while the app displays the processing stages: detecting the face, checking image quality, confirming a live face, creating the template, preparing the face image and uploading it.
Step by step
- Open the overflow menu (⋮) on the kiosk home screen and tap Members.
- Tap the unenrolled member’s row. The app opens the Face Consent screen.
- Read the consent prompt to the member and tap I agree when they confirm. (NDPA compliance : see Privacy Policy.)
- The camera opens with the FRONT prompt and Step 1 of 1 on screen.
- The member stands about 50 cm from the camera, centres their face in the oval and looks straight ahead.
- Tap Capture once. The member should continue looking forward and hold still while quality and liveness are checked.
- If the checks pass, the app creates one face template and one face-focused image, then uploads them to the server.
- When the server confirms the upload, the member is shown as Enrolled in the Members list.
When a capture is rejected
Common rejection messages and what they mean:
| Message | Cause | Fix |
|---|---|---|
| Center your face in the oval | Face is off to one side of the frame. | Member should stand directly in front of the camera. |
| Move a little closer to the camera | Member is too far from the camera. | Step in to about arm’s length. |
| Face the camera straight on | Member is looking off-axis or has turned their head. | Look straight at the camera; don’t turn the head left/right or tilt it. |
| Find a brighter spot / Move away from direct light or glare | Lighting is too dark, too bright or strongly backlit. | Move so soft, even light is in front of the member. |
| Hold still — the image was blurry | Member moved during capture or the camera could not focus. | Hold still, keep the device steady and try again. |
| Could not confirm a live face | The liveness check could not get a reliable result. | Improve the lighting, keep the complete face visible and hold still before trying again. |
| Liveness check failed | The image did not pass the live-person check. | Use the member’s live face, not a photograph or another screen. |
The app waits about 600 ms between capture attempts to prevent tap-spam. If you cannot tap Capture again immediately after a rejection, that is why.
If enrolment fails completely
- Try one more time. Most failures clear with better lighting and a clearer pose.
- Try a different angle of the device. Glare on the screen, ceiling lights reflecting in glasses, and shadows from a hat brim are common silent failures.
- Check the internet. The upload step requires a working connection; without it enrolment cannot be completed.
- Do not let someone else’s face be captured under this member’s profile. That breaks attendance accuracy and is treated as a security incident in the audit log. If a member genuinely can’t be enrolled, contact support.
Re-enrolling a member
Members change. Beards grow, beards go, glasses get bought, weight shifts, hairlines move. If a member’s daily verification rate drops noticeably, ask an admin to re-enrol them: open the overflow menu, tap Members, open the member’s row, and tap Re-enrol. The new FRONT template and face-focused image replace the previous ones.
Next
Enrolled members are ready for daily use. See Daily Clock-In & Clock-Out.