> 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`   | No liveness check by movement.                            |
| `Move`    | `2`   | Activates the liveness check by movement (liveness move). |
| `Passive` | `3`   | Compatibility; has no effect (see below).                 |

## Morphology

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

selphi.livenessMode = LivenessMode.Move;
```

## Description

Select the liveness check mode of `facephi-selphi-widget`. The recommended way to enable liveness move is to define `livenessMode = LivenessMode.Move` along 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 enables move for compatibility, but it is **deprecated**: `livenessMode = LivenessMode.Move` and 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 reported)   | No liveness check             | No 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}
/>
```