Enable Biometrics property

Official Content
This documentation is valid for:
Establishes whether the application will use biometrics for user authentication; it requires to log in only once.




Objects: Menu, Panel, Work With (Only Main Objects)
Generators: Android, Apple


Enables GAM users to access the app through the biometric authentication of the device used. 

When the user first logs into the application by using its username and password -in the case that the device has biometrics sensors and they are turned on- the application will ask if it should use biometrics security the next time. If the user wants to use biometrics (fingerprint or face recognition), then the next time she/he enters the application, it will ask for a biometrics authentication instead of asking for username and password.

Runtime/Design time

This property applies only at design-time.


In an SD application with Integrated Security = True, in the properties of Main SD object, under the Integrated Security node, set the Enable Biometrics property as True. 

For cases of Android devices, face recognition is not available in versions lower than Android 9 (API 28).

For is devices Face ID Usage Description property must be set in order to use this feature. It can be found in the Purpose String.

Example of Android devices: 

After entering the app's login data for the first time, the screen will show the following message:


 When the user indicates that the biometric authentication will be used, a credential verification will be required, and the following screen will be shown:  



For the case of iOS, the verification of biometric data will not be required upon the login, but rather the next time that the application is initiated, or upon the expiry of the time indicated in the Biometrics Reuse Duration property




How to apply changes

To apply the corresponding changes when the property value is configured, Build the Main Object.


This property is available since GeneXus 16 upgrade 7.

See Also

Secure Application Content

Biometrics Reuse Duration property

Integrated Security Level property

GeneXus Access Manager (GAM)