> 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/selphid-documentos/propiedades.md).

# Properties

These properties allow you to customize the behavior of the Document Capture Flow.

## Constants and typing

SelphID offers types and constants to facilitate implementation in typed environments.

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

In React, the enum `CameraPreferred` (among others) is also exported from `@facephi/sdk-web-react`.

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

***

## SelphID Widget configuration properties

### Capture

* [allowUncertain](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/allowuncertain.md): Increases permissiveness for unrecognized documents.
* [allowUnknown](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/allowunknown.md): Allows capturing any document with a photo.
* [barcode](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcode.md): Enables the barcode and QR reader.
* [barcodeSide](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcodeside.md): Side of the document where the code is read.
* [blurredThreshold](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/blurredthreshold.md): Blur tolerance threshold.
* [captureRetries](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md): Maximum number of capture retries.
* [captureTimeout](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturetimeout.md): Capture time limit per attempt (seconds).
* [country](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/country.md): Document country in ISO-2. **Deprecated:** use `countryFilter`.
* [countryFilter](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/countryfilter.md): Allowed countries in ISO-2. **Recommended:** `enabledCountries`.
* [documentType](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/documenttype.md): Supported document types in capture.
* [expectedSides](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/expectedsides.md): Number of document sides to capture.
* [maxAllowedMismatches](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/maxallowedmismatches.md): OCR errors allowed per word.
* [maxAttempts](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/maxattempts.md): Maximum number of document capture attempts.
* [progressiveMismatches](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/progressivemismatches.md): Increased permissiveness on each retry.
* [retryCurrentSide](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/retrycurrentside.md): Retries only the current side of the document.
* [rules](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/rules.md): Rules for filtering capture by country.

### Extraction

* [anonymizationMode](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/anonymizationmode.md): Anonymization mode for extracted data.
* [capturePadding](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturepadding.md): Margin added to the captured image.
* [cropFactor](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cropfactor.md): Scaling factor for the document crop.
* [imageFormat](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/imageformat.md): Format of the returned images.
* [imageQuality](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/imagequality.md): JPEG compression (0.0–1.0).
* [tokenize](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/tokenize.md): Enables result tokenization.

### Camera

* [cameraHeight](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraheight.md): Preferred vertical camera resolution.
* [cameraId](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraid.md): Camera identifier.
* [cameraSwitch](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraswitch.md): Shows the button to switch cameras.
* [cameraType](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameratype.md): Camera type (front or rear). **Recommended:** `cameraPreferred`.
* [cameraWidth](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/camerawidth.md): Preferred horizontal camera resolution.
* [dpi](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/dpi.md): DPI of the extracted images.
* [externalCamera](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/externalcamera.md): External video Flow for capture.

### Customization

* [audible](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/audible.md): Enables text-to-speech reading.
* [cameraOverflow](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraoverflow.md): Shows the entire camera image as a background.
* [chooseDocument](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/choosedocument.md): Enables prior document selection. **Recommended:** `showDocumentSelector`.
* [disableExit](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/disableexit.md): Hides the widget close button. **Recommended:** `showExitButton`.
* [disableTutorial](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/disabletutorial.md): Disables access to the tutorial. **Recommended:** `showTutorial`.
* [enableDocumentFlip](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/enabledocumentflip.md): Enables the document flip animation.
* [initialTip](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtip.md): Shows a tip before capture. **Recommended:** `showPreviousTip`.
* [initialTipHeight](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtipheight.md): Height of the initial tip in pixels.
* [initialTipWidth](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtipwidth.md): Width of the initial tip in pixels.
* [tipAnimations](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/tipanimations.md): Initial tip animations (mobile and desktop).
* [loadingAnimation](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/loadinganimation.md): Path of the loading animation.
* [logo](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/logo.md): Path of the custom logo.
* [previewImage](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/previewimage.md): Shows preview after capture. **Recommended:** `showResultAfterCapture`.
* [tutorialAnimations](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/tutorialanimations.md): Custom tutorial animations.
* [tutorialModal](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/tutorialmodal.md): Shows the tutorial in modal mode.

### Internal configuration

* [advancedTracking](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/advancedtracking.md): Enables advanced tracking generation.
* [androidWebViewBehaviour](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/androidwebviewbehaviour.md): Behavior in Android WebView.
* [engineFallback](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/enginefallback.md): Enables the secondary engine.
* [engineLocation](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/enginelocation.md): Path or CDN of the engine resources.
* [errorTimer](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/errortimer.md): Duration of terminal error views.
* [settingsStrictness](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/propiedades/settingsstrictness.md): Shows an error if there are misconfigured parameters.

### Video Recording

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

### Developer tools

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

***

## Property compatibility and validation

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

* **Precedence:** if you define both the legacy name and the new one at the same time, 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 with its default value and a warning is emitted; in strict mode, it stops the SDK with a blocking error.