Introducing VIDA Identity Stack: All of VIDA, in one place 🎉
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Change Logs

This document outlines the updates of the VIDA Web SDK across key versions. Each release includes categorized details covering new capabilities, security enhancements, and critical backend improvements to ensure a secure, performant, and user-friendly experience.

Feature: New functionalities and enhancements in this release.

Bug Fixes: Resolving issues and glitches for a smoother experience.

Security Update: Updates addressing potential vulnerabilities for improved security.

Performance Improvement: Optimisations for faster and more efficient usage.

Releases

1.2.0

Feature

Date: Aug 18th, 2026

Liveness SDK: Tutorial screen changes

  • Updated the tutorial images and text contents

  • New fields for locale customization

1.1.3

CDN:

NPM:

Sandbox : yarn add vida-web-sdk@1.1.3-sandbox / npm install vida-web-sdk@1.1.3-sandbox Prod : yarn add vida-web-sdk / npm install vida-web-sdk

Feature

Date: Jul 21th, 2026

  • VidaSDK.preload() - Introduced a new method which preload() prefetches SDK assets in the background so they are already cached when the SDK starts the flow. This reduces perceived load time for the end user.

  • userInfo.Id is made an optional parameter for init() method now for Liveness+Id Fraud shield combined offering.

  • Added an exit confirmation pop-up if user tries to manually close the modal during the process, if there is a retry or flow completion possibility.

1.1.1

Feature

Date: Apr 28th, 2026

  • Integration with the ID Fraud Shield SDK, enabling risk-based actions across both Liveness and KYC flows.

  • Enhanced callback responses with more details to improve visibility during the liveness process.

  • onComplete(data) - this callback fires once when liveness passes; returns the successful liveness result. Treat as the success signal. onError(data) - this callback fires only at terminal, flow-ending states (max-retry exhausted, session expired, detection timeout, camera/startup errors, manual close). Retry-able liveness failures do not trigger it — except with skipSelfieReviewScreen, where each failure is terminal. onLivenessApiResponse(data) — this callback fires on every liveness API response whether the attempt passed or failed on threshold/image quality. Can be used for per-attempt observability, not a terminal signal.

Performance Improvement

Enhanced fraud detection through combined KYC and risk-based validation.

1.1.0

Feature Date: Jan 12th, 2026

Color Flash: New passive liveness detection using color flashes to improve spoof detection while keeping the user experience seamless.

Geo-X Identity Verification : New Geo-X KYC support with flexible verification flows:

  • Full KYC: OCR + Document Verification + Liveness + Face Match

  • Document Verification Only: OCR + Document Verification

Screen Flash Feature for Liveness : The Web SDK automatically triggers a screen flash when lighting is too dark, helping users capture clearer selfie images and improving verification success.

  • Enhanced UI for Liveness :

    • Larger Web SDK modal for better visibility

    • Redesigned liveness tutorial screen

    • Camera help moved to bottom sheet for easier access

    • Configurable head guide icon to help users position their face correctly

Liveness Tutorial Screen

Earlier versions

New Version

Tutorial now has 2 instructions (4 earlier). The earlier text content customization keys for tutorial screen have been deprecated and new ones introduced.

Deprecated Keys

tutorial: {
  faceCamera: string;
  faceClear: string;
  singleFace: string;
  avoidDark: string;
}

New Keys

livenessTutorial: {
  holdPhoneSteady: string;
  avoidBrightPlace: string; /* For color flash liveness */
  avoidGlasses: string; /* For passive liveness */
}

Selfie capture camera screen

Earlier Versions

New Versions

Default instructions changed on selfie capture feedback section

Old Version
New Version

Place your face within the frame

Put your face in the frame

Bring your face closer

Move closer

Stay still to capture clear photo

Stay still

Unable to detect the face

Put your face in the frame

Face too dark

Move to well-lit area

Face area too bright

Too bright

Make sure your eyes are open and visible

Open your eyes

1.0.6

Bug Fixes Date: Nov 25th, 2025

  • Modal size issue : Resolved an issue where the web SDK modal size was being rendered in small size in some tablet devices.

  • Darkness check enhancement : Slightly tightened the threshold for dark area check.

  • Camera - Feedback text size customization : Fixed an issue where the custom font size for camera real time feedback text was not getting applied.

1.0.5

Feature Date: Sept 24th, 2025

  • detectionTimeOutCountdownDuration

    • Added support to configure timeout in milliseconds for face detection countdown.

    • Default: 20,000 ms (20 seconds).

    • Example: Passing 30,000 will show countdown for the last 30 seconds.

  • hideDetectionTimeOutCountdownAlert (boolean)

    • New option to hide the countdown alert.

    • Default: false.

  • hideMaxRetryError (boolean)

    • New option to hide the "Maximum retry exhausted" error alert on the selfie review screen.

  • hideDescriptions (object)

    • New configurable object to hide page descriptions across different screens.

    • Defaults: all descriptions shown.

  • Available options:

    • tutorial – Tutorial screen

    • cameraAccess – Camera access screen

    • camera – Selfie capture screen

    • selfieReview – Selfie review screen

  • hideErrorCodeOnSelfieReview (boolean)

    • New option to hide error codes on the selfie review screen.

    • Default: false.

networkStatus (string)

  • Custom label for network status alert (shown when there is no internet connection).

error.moduleDownloadErrorTitle (string)

  • Error title text for camera error when model download fails.

error.moduleDownloadErrorDescription (string)

  • Error description text for camera error when model download fails.

error.unsupportedDeviceTitle (string)

  • Error title text for camera error due to unsupported device.

error.unsupportedDeviceDescription (string)

  • Error description text for camera error due to unsupported device.

detectionTimeOut (string)

  • Custom label for detection timeout alert.

  • Supports template \${time} which will be replaced with actual timeout value.

sessionExpired (string)

  • Message when session gets expired.

unknownError (string)

  • Message when an unknown error occurs.

maxRetryExhausted (string)

  • Message when maximum retries are exhausted.

1.0.4

Performance Improvement Date: Aug 06th, 2025 Self hosted face detection models and assets: Removed dependency of external CDN for models and assets.

1.0.3

Security Update Date: Jun 30th, 2025 Enhanced Signing Key Protection: Implemented stronger encryption algorithms mechanisms for SDK signing keys.

1.0.2

Security Update Date: Mar 25th, 2025 Generic camera security updates to strengthen security checks in the camera module.

1.0.1

Security Update Date: Jan 18th, 2025 Anti-Debugging Measures Introduced: Strengthened SDK resilience against tampering by detecting and blocking debugging attempts in the browser environment.

1.0.0

Feature Date: Jan 17th, 2025

  • Initial Launch of the Web SDK: Introduce web SDK for Passive Liveness check

  • Passive Liveness Detection: The SDK integrates liveness analysis to verify if a real person is present, without requiring user action like blinking or head movement.

  • Real-time Selfie Quality Feedback: The SDK provides instant user guidance to optimize image quality (e.g., lighting, framing, focus), improving the success rate of facial verification on the first attempt.

Last updated