WebSDK Installation

Install the IDWise Web SDK on your web page and add the mount element where the verification flow will appear.

Latest Stable Version

Use the latest stable Web SDK version from the IDWise CDN. For release history and version details, see the Web SDK Release Notes.

Install the Web SDK

Add the Web SDK stylesheet and script to the page that will host the IDWise verification flow:

<script src="https://releases.idwise.com/websdk/latest/idwise.min.js"></script>

Smart Capture

From Web SDK 7.0.0, Smart Capture is the default capture experience. Instead of relying on the user to press a shutter button, the SDK analyses the camera feed in real time, guides the user to a good frame, and captures automatically.

No installation step or configuration flag is needed. Smart Capture ships inside the standard Web SDK bundle and is active out of the box on document and selfie capture steps, on mobile and desktop browsers. If you have completed Install the Web SDK, you already have it.

Manual capture remains available as a fallback. If a user's device or browser cannot run Smart Capture, the SDK switches to manual capture automatically and the journey continues without interruption.

Optional: Preload Smart Capture Assets

Smart Capture downloads machine learning assets before the camera step. By default the SDK downloads only what a journey needs, at journey start. To start that download as early as possible, pass preloadSmartCapture: true to initialize():

const idwise = await IDWise.initialize({
  clientKey: "<your-client-key>",
  preloadSmartCapture: true,
});

This begins downloading the moment initialize() is called, before authentication completes, which gives users on slower connections a head start. It fetches assets for both document and selfie capture.

Optional: Pin a Specific SDK Version

By default, the latest CDN path loads the latest stable Web SDK version. If you want to lock your integration to a specific SDK version, replace latest in both URLs with the version number.

Version numbers use the x.y.z format, such as 6.6.1.

<script src="https://releases.idwise.com/websdk/x.y.z/idwise.min.js"></script>

Use version pinning when you want to control when SDK upgrades are applied to your production environment.

Optional: Self-Host the Web SDK Build Files

If your security or infrastructure requirements prevent loading the Web SDK JavaScript and CSS files from the IDWise CDN, you can self-host the Web SDK build files on your own servers.

For the full setup steps, see Advanced WebSDK Usage.

Add a Mount Element

Add an HTML element where the IDWise UI will be rendered. This can be any block element with a unique CSS selector:

<div id="idwise-mount"></div>

Next Steps

After installing the SDK and adding the mount element, continue to Web SDK Usage to initialize the SDK and start a journey.