> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/kyc-web-sdk/change-logs.md).

# Change Logs

This document logs all modifications made to the **KYC Web SDK**, keeping our partners informed of the most recent version.

Each release is organized by tags. These tags give you a quick idea of the changes—whether they include new features, bug fixes, or important security updates.

<mark style="color:$success;background-color:green;">**Feature**</mark>: New functionalities and enhancements in this release.

<mark style="background-color:orange;">**Bug Fixes**</mark>: Resolving issues and glitches for a smoother experience.

<mark style="background-color:red;">**Security Update**</mark>: Updates addressing potential vulnerabilities for improved security.

<mark style="background-color:purple;">**Device Support**</mark>: Added support to device versions.

<mark style="color:blue;background-color:yellow;">**Performance Improvement**</mark>: Optimisations for faster and more efficient usage.

#### Releases

<details>

<summary>1.2.0</summary>

<mark style="color:$success;background-color:green;">**Feature**</mark>

Date: Aug 18th, 2026

**New Workflow for - Identity Verification Authoritative**, for Indonesia ( Indo KYC Flow )

New verificationType: 'authoritative' option in `workflowConfigs.identityVerification` enables a full step-up KYC flow for Indonesian users, orchestrated by the backend:

Doc Capture → OTP Verification → Personal Info Review → Demographic Verification → Liveness → Face Match

{% code expandable="true" %}

```java
VidaSDK.init({
  workflow: 'identity-verification',
  workflowConfigs: {
    identityVerification: {
      verificationType: 'authoritative',   // ← new
    },
  },
});
```

{% endcode %}

Key capabilities:

* **OTP verification** - users verify their phone number via OTP delivery channel (SMS, WhatsApp.)
* **KTP Capture** - users capture their KTP to perform Doc Verification/OCR
* **Personal Info (PI) review** - extracted OCR fields (NIK, name, DOB, etc.) are displayed for review; editable fields can be corrected before submission
* **Demographic verification** - ID data is matched against authoritative registry
* **Liveness + Face Match** - stitched automatically after demographic verification passes. Face match done against authoritative registry.
* **Manual review flow** - if submission triggers a manual review queue, the SDK shows a "review in progress" screen and surfaces the result when ready
* **Resume flow** - returning users with the same clientTransactionId resume from the step they left off;
* **Fraud Shield** - ID Fraud Shield runs automatically at the final KYC step for, if enabled.

**Single NPM Build for Sandbox & Production**

For customers using npm integration - `init()` now accepts an optional env parameter. The NPM package is now a single build that targets both sandbox and production; the environment is selected at runtime via this param (previously required separate packages for sandbox and production).

{% code expandable="true" %}

```java
yarn add vida-web-sdk -OR- npm install vida-web-sdk

VidaSDK.init({
  env: 'sandbox',      // or 'production' (default)
  ...
});
```

{% endcode %}

**Theme Config - Link Text Button Colours**

Three new optional keys added to themeConfigs for customising hyperlink-style buttons (used in introduction / OTP screens, etc):

{% code expandable="true" %}

```java
themeConfigs: {
  linkTextButtonColor?: string;
  linkTextButtonHoverColor?: string;
  linkTextButtonDisabledColor?: string;
}
```

{% endcode %}

**Geo-X KYC SDK flow : UI Improvements**

* IDV Introduction screen - refreshed layout and icon sizing
* IDV Error screen - layout and messaging improvements; Updated warning icon used; Alert box for remaining attempts and max attempts exhausted cases;
* In ID Card capture screen - highlighted capture feedback text

**Liveness SDK : Tutorial screen changes** - Updated the tutorial images and text contents. New fields for locale customization.

</details>

<details>

<summary>1.1.3</summary>

**CDN:**

{% hint style="info" %}
Sandbox : <https://web-sdk.vida.id/1.1.3/sandbox/vida-web-sdk.js> \
Prod : <https://web-sdk.vida.id/1.1.3/vida-web-sdk.js>&#x20;
{% endhint %}

**NPM:**

{% hint style="info" %}
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
{% endhint %}

<mark style="color:$success;background-color:green;">**Feature**</mark>

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.

</details>

<details>

<summary>1.1.1</summary>

**CDN:**

{% hint style="info" %}
<https://web-sdk.vida.id/1.1.1/sandbox/vida-web-sdk.js>
{% endhint %}

**NPM:**

{% hint style="info" %}
[https://www.npmjs.com/package/vida-web-sdk](<https://www.npmjs.com/package/vida-web-sdk&#xA;&#xA;>)
{% endhint %}

<mark style="color:$success;background-color:green;">**Feature**</mark>

* Separate handling of front and back ID images for more adaptable verification flows.
* Enhanced callback responses with more detailed status information to improve visibility during the verification process.
* Integration with the ID Fraud Shield SDK, enabling risk-based actions across both Liveness and KYC flows.

<mark style="background-color:red;">**Security Update**</mark>

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

</details>

<details>

<summary>1.1.0</summary>

**CDN:**

{% hint style="info" %}
<https://web-sdk.vida.id/1.1.0/sandbox/vida-web-sdk.js>
{% endhint %}

**NPM:**

{% hint style="info" %}
<https://www.npmjs.com/package/vida-web-sdk>
{% endhint %}

</details>
