> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades.md).

# Properties

These properties allow customizing the behavior of the facial pattern capture flow.

## Constants and typing

Selphi offers types and constants to make implementation easier in typed environments.

```javascript
import { CameraType, CameraPreferred, LivenessMode } from '@facephi/selphi-web-component'
```

In React, these enums (`CameraPreferred` and `LivenessMode`, among others) are also exported from `@facephi/sdk-web-react`.

> **Recommendation:** Configure the properties via JavaScript, JSX, or your framework bindings (React, Vue, Angular, etc.). Avoid native HTML configuration with attributes (`nombre-atributo="valor"`), since it may lose the typing and the format expected by the component.

***

## Selphi Widget configuration properties

#### Capture

* [maxAttempts](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md): Maximum number of Face Capture attempts.
* [stabilization](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/stabilization.md): Enables face stabilization during capture.
* [timeout](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/timeout.md): Time limit in milliseconds to capture the face.

#### Extraction

* [cropFactor](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cropfactor.md): Face crop enlargement factor.
* [imageFormat](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imageformat.md): Format of the images returned by the Widget.
* [imageQuality](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imagequality.md): JPEG compression level (0.0–1.0).
* [logImages](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logimages.md): Returns the best images used in extraction.
* [templateFormat](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/templateformat.md): Biometric Template generation format.
* [antispoof](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoof.md): Enables fraud detection (anti-spoofing).
* [antispoofPayloadSize](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoofpayloadsize.md): Anti-spoofing payload size.

#### Camera

* [cameraHeight](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraheight.md): Preferred camera vertical resolution.
* [cameraId](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraid.md): Identifier of the camera to use.
* [cameraSwitch](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraswitch.md): Shows the button to switch cameras.
* [cameraType](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameratype.md): Camera type (front or rear). **Recommended:** `cameraPreferred`.
* [cameraWidth](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerawidth.md): Preferred camera horizontal resolution.
* [externalCamera](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/externalcamera.md): External video stream for capture.
* [cameraRotation](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerarotation.md): Rotation applied to the camera image.

#### Customization

* [audible](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/audible.md): Enables text-to-speech reading.
* [disableExit](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disableexit.md): Hides the button to close the Widget. **Recommended:** `showExitButton`.
* [disableTutorial](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disabletutorial.md): Disables access to the tutorial. **Recommended:** `showTutorial`.
* [faceTracking](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/facetracking.md): Centers the face before capture.
* [initialTip](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtip.md): Shows a pre-capture tip. **Recommended:** `showPreviousTip`.
* [initialTipHeight](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipheight.md): Height of the initial tip in pixels.
* [initialTipWidth](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipwidth.md): Width of the initial tip in pixels.
* [interactible](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/interactible.md): Requires user interaction to start.
* [tipAnimations](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tipanimations.md): Initial tip animations (mobile and desktop).
* [livenessMode](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmode.md): Widget liveness check mode.
* [livenessMoveFailedAttempts](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovefailedattempts.md): Allowed failed attempts in Active Liveness. **Recommended:** `moveFailedAttempts`.
* [livenessMoveSteps](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovesteps.md): Required steps in the Active Liveness check. **Recommended:** `moveSuccessfulAttempts`.
* [livenessMoveTimeout](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovetimeout.md): Time per step of Active Liveness (seconds).
* [loadingAnimation](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/loadinganimation.md): Path to the custom loading animation.
* [logo](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logo.md): Path to the custom logo.
* [previewImage](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/previewimage.md): Shows a preview after capture. **Recommended:** `showResultAfterCapture`.
* [tutorialAnimations](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialanimations.md): Custom tutorial animations.
* [tutorialModal](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialmodal.md): Shows the tutorial in modal mode.

#### Internal configuration

* [advancedTracking](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/advancedtracking.md): Enables advanced Tracking generation.
* [androidWebViewBehaviour](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/androidwebviewbehaviour.md): Behavior in Android WebView.
* [diagnosticTimer](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/diagnostictimer.md): Online diagnostic time before the error.
* [engineLocation](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enginelocation.md): Path or CDN of the engine resources.
* [errorTimer](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/errortimer.md): Duration of the terminal error views.
* [settingsStrictness](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/settingsstrictness.md): Shows an error if there are misconfigured parameters.

#### Video Recording

* [enableVideoTimer](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enablevideotimer.md): Shows a timer during Video Recording.
* [videoRecord](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecord.md): Enables Video Recording in the session.
* [videoRecordAudio](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordaudio.md): Records audio in the local recording.
* [videoRecordQuality](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordquality.md): Quality of the Video Recording.
* [videoRecordRate](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordrate.md): Frame rate of the remote recording.
* [videoRecordType](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordtype.md): Recording type (local or remote).

#### Developer tools

* [debug](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/debug.md): Enables on-screen debug mode.
* [showLog](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/showlog.md): Outputs detailed information to the console.

***

## Property compatibility and validation

Some properties have been renamed. The legacy name is still the main and operational one in this version, while the new name is the **recommended**. Resolution rules:

* **Precedence:** if you define both the legacy and the new name, the **new** wins and a precedence warning is emitted in the console.
* **Legacy only:** using only the legacy name emits a deprecation warning in the console. The legacy name will be removed in the next major version.
* **Unknown property:** an unrecognized property is **silently ignored** always.
* **Validation (**[**settingsStrictness**](/docs.facephi-en/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md)**, tolerant by default):** in tolerant mode, an invalid value is replaced by its default value and a warning is emitted; in strict mode, it stops the SDK with a blocking error.