> 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/livenessmode.md).

# livenessMode

## Details

**Attribute:** `liveness-mode`

**Type:** `LivenessMode`

**Default value:** `LivenessMode.None`

### LivenessMode

| Member    | Value | Description                                             |
| --------- | ----- | ------------------------------------------------------- |
| `None`    | `0`   | Without liveness check by movement.                     |
| `Move`    | `2`   | Enables the liveness check by movement (liveness move). |
| `Passive` | `3`   | Compatibility; it has no effect (see below).            |

## Morphology

```typescript
import { LivenessMode } from '@facephi/selphi-web-component';

selphi.livenessMode = LivenessMode.Move;
```

## Description

Select the liveness check mode for `facephi-selphi-widget`. The recommended way to enable liveness move is to define `livenessMode = LivenessMode.Move` together with the steps (`livenessMoveSteps`, or its recommended name [`moveSuccessfulAttempts`](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovesteps.md)).

Defining only the steps (without `Move`) still activates the move for compatibility, but it is **deprecated**: `livenessMode = LivenessMode.Move` will be mandatory in the next major version. The value `Passive` has no effect and will also be removed in the next major version.

### Behavior

The result for incomplete or contradictory combinations depends on [`settingsStrictness`](/docs.facephi-en/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md):

| Scenario                   | Tolerant (default)            | Strict                     |
| -------------------------- | ----------------------------- | -------------------------- |
| `Move` + steps > `0`       | Move with those steps         | Move with those steps      |
| `Move` + steps = `0`       | Move with `3` steps + warning | Blocking error             |
| Steps > `0` without `Move` | Move + deprecation warning    | Move + deprecation warning |
| `None` (or not specified)  | Without liveness check        | Without liveness check     |
| `Passive`                  | Discarded (no effect)         | Discarded (no effect)      |

***

## Example

```jsx
import { LivenessMode } from '@facephi/selphi-web-component';

<facephi-selphi-widget
    livenessMode={LivenessMode.Move}
    moveSuccessfulAttempts={3}
/>
```