Why This Setup Step Matters

Face Recognition Login in iVendNext POS gives cashiers and operators a way to authenticate without typing a password. Instead of entering credentials, the user looks at the camera and is logged in within seconds. The practical benefit in a retail environment is meaningful: shared terminals no longer require everyone to type their individual password, and operators who are handling merchandise or wearing gloves do not need to stop what they are doing to type.

Before any of this works, two things must happen: an administrator must enable the feature in System Settings, and each user who will use Face ID must be enrolled — meaning a reference face photo must be registered for them. Neither of these steps happens automatically. This article explains both.

Enabling Face Login in System Settings

Face login is off by default. The feature is controlled by a single checkbox in iVendNext Desk.

To enable it:

1. Log in to iVendNext Desk as a System Manager.

2. Navigate to Settings → System Settings.

3. Scroll to the iVendNext POS section.

4. Tick the checkbox labelled Allow Login using Face Recognition.

5. Click Save.

Once saved, the Login with Face ID button becomes visible on the iVendNext POS login page at /login. Before this setting is enabled, the button does not appear at all — users have no way to attempt face login regardless of whether they have been enrolled.

To disable the feature for all users at any time, simply untick the same checkbox and save. The button disappears from the login page immediately. Existing User Face Maps records are not deleted — they remain in the system and will work again if the feature is re-enabled.

The User Face Maps DocType

User enrolment is managed through a DocType called User Face Maps. This is where the administrator registers the reference face for each user who will use Face ID login.

Each User Face Maps record contains three fields:

• User — a link to the Frappe user record this mapping belongs to.

• User Face — the attached reference photograph. This is the image the system uses to generate a face encoding.

• Image Info — a computed field populated automatically on save. It stores the 128-dimension numerical encoding derived from the reference photo. You do not fill this field manually.

Only users with the System Manager role can create, edit, or delete User Face Maps records. Cashiers and store managers cannot access this DocType directly.

One important constraint: only one face mapping per user is supported. Each user has a single reference photo and a single encoding at any time.

Enrolling a User — Method A: Photo Upload

Use this method when you have an existing photograph of the user, such as an HR photo or identity document scan.

1. Navigate to iVendNext POS → User Face Maps.

2. Click New.

3. In the User field, select the user you want to enrol.

4. In the User Face field, click Attach and upload the photograph.

5. Click Save.

Photo requirements for a successful enrolment:

• The photo must contain exactly one face — photos with multiple people will fail.

• The face should be front-facing, well-lit, and looking directly at the camera.

• There should be no obstructions covering the face.

• Supported formats are JPEG and PNG.

After saving, the system analyses the photo automatically and generates the encoding. Two outcomes are possible:

If enrolment fails, the Image Info field remains empty. The user cannot log in with Face ID until a valid encoding is stored. Check the Frappe Error Log (search for "Face Encoding Error") for details if the failure is unexpected.

Enrolling a User — Method B: Live Camera Capture

Use this method to capture the user's face in real time rather than uploading a photo. This approach tends to produce better results because the image is taken under actual working conditions.

1. Navigate to Settings → User and open the user's record.

2. Click Actions → Register Face Map. If a face mapping already exists, this button shows as Update Face Map instead.

3. A camera modal opens. Follow the on-screen prompts:

• Blink naturally. The green progress bar at the bottom of the camera view will begin to fill.

• Make a subtle head movement — a small nod or slight side turn. The bar will continue filling.

• Once the bar reaches 100%, look directly into the camera with eyes open and hold still.

• The system captures the image automatically. You do not press anything.

4. The modal closes after a successful capture, and a notification confirms: "Face mapping successful."

Clicking anywhere on the dark overlay behind the modal will cancel the capture and close the modal without saving.