> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/facial-recognition/enrol-face-distributor.md).
# Enrol Face: Distributor
## Overview
This is a one-time setup, done the first time you open the Facial Recognition APK. It requires an internet connection. You cannot use the app until enrollment is complete.
## Steps
{% stepper %}
{% step %}
### Start enrollment and read the capture guidance
* Open the Facial Recognition APK. The Face Enrollment screen opens automatically. It lists the six steps you are about to complete: look straight at the camera, complete the liveness check, turn slightly left, turn slightly right, look slightly up, and look slightly down.
* Tap Continue. The Before We Begin screen appears with five capture instructions: Good Lighting, Clear Face Visibility, Correct Distance, Keep Your Phone Steady, and Follow Onscreen Guidance. Scroll through all five.
* Continue. The camera opens, and the guided capture begins.
{% endstep %}
{% step %}
### Capture the six angles
The app guides you one angle at a time. A row of numbered dots across the top tracks your progress; each dot turns green as that capture is accepted. A brightness bar on the left shows whether the light is adequate.
* Follow the prompt at the top of the screen. The prompt changes as you go: Look straight at the camera, Turn your head to the left, Turn your head to the right, Look slightly up, Tilt your head slightly down.
* Hold the position. When the app sees your face, it shows Face detected — tap capture. Tap the camera button. While it processes, you will see Hold still, capturing… followed by Scanning 1/5, 2/5, and so on.
* Complete the liveness check. When prompted with Blink your eyes, blink normally. This confirms a live person is in front of the camera.
* Continue until all dots are green. If a capture is rejected, the app repeats the prompt. Re-enrollment is supported if the overall quality is not good enough, so you can start again rather than proceed with a weak profile.
* Wait while the profile is saved. You will see Setting up your profile… while the profile is stored on the device and synced to the backend.
{% hint style="info" %}
**If capture keeps failing**
Move away from a bright window or a light directly behind you — backlight is the most common cause of a rejected capture.
Remove glasses, a mask, or anything covering your face.
Keep the phone 30–40 cm from your face and hold it steady.
Turn your head only slightly. A full profile turn will not be accepted.
{% endhint %}
{% endstep %}
{% step %}
### Save your backup PIN
* Read the Enrollment Successful screen. It confirms your face has been enrolled and shows your four-digit enrollment PIN.
* Record the PIN. Tap Copy, or write it down. This is the only time the PIN is displayed. You will need it if face verification does not pass.
* Tap Continue. You are taken to the login screen and can begin using the app.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
**Pilot security note: default PIN**
In this pilot build, the enrollment PIN is issued as a default value rather than a randomly generated one. This is a known trade-off recorded against the release and must be reviewed before any production rollout. Treat the PIN as a fallback of last resort, not a routine alternative to the face scan.
{% endhint %}
{% hint style="info" %}
**Common errors during enrolment**
Face already enrolled: the face you scanned closely matches a profile that already exists, and the app shows the match percentage. Tap Go Back and retry for a different profile. Duplicate enrollment is managed by the supervisor SOP in this release, not automatically.
No internet: enrollment cannot complete without a connection. Move to a location with signal before starting. Do not begin enrollment offline.
Wrong person captured: if the wrong face is captured mid-sequence, exit and start the enrollment again. A profile must belong to exactly one person.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.digit.org/health/access/public-health-product-suite/health-campaign-management-hcm/facial-recognition/enrol-face-distributor.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
