> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urtentic.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Web SDK
> Integrate identity verification into your web application with pre-built UI components and a JavaScript API.
The Urtentic Web SDK provides a simple way to integrate identity verification into your web application. It offers pre-built UI components and a JavaScript API to guide users through the verification process.
## Installation
Include the SDK via CDN:
```html theme={null}
```
## Integration Options
The Urtentic Web SDK offers two main integration options:
Pre-built UI components for quick integration with the `` element
Direct SDK initialization for custom UI implementations with full control
## Using Web Components
The SDK provides the `` web component which creates a customizable verification button.
### Add the Button to Your HTML
```html theme={null}
Urtentic Verification Example
User Verification
```
### Handling Verification Events
```javascript theme={null}
const verificationButton = document.querySelector('urtentic-button');
// SDK loaded and ready
verificationButton.addEventListener('urtentic:loaded', (event) => {
console.log('SDK loaded and ready');
});
// User started the verification process
verificationButton.addEventListener('urtentic:userStartedSdk', (event) => {
console.log('User started verification', event.detail);
});
// Verification complete
verificationButton.addEventListener('urtentic:userFinishedSdk', (event) => {
console.log('Verification complete', event.detail);
});
// User exited the verification flow
verificationButton.addEventListener('urtentic:exitedSdk', (event) => {
console.log('User exited verification', event.detail);
});
```
## Using the JavaScript API
For more control over the verification flow, use the JavaScript API directly. Call `Urtentic.init()` from any event — here triggered by a custom button:
```html theme={null}
User Verification
```
## Configuration Parameters
| Parameter | Type | Required | Description |
| ----------------- | -------- | -------- | -------------------------------------- |
| `clientId` | String | Yes | Your Urtentic client ID |
| `flowId` | String | Yes | The ID of the verification flow |
| `metadata` | String | No | JSON string with additional data |
| `redirect` | String | No | Redirect URL after completion |
| `userStartedSdk` | Function | No | Callback when user starts verification |
| `userFinishedSdk` | Function | No | Callback when verification is complete |
| `exitedSdk` | Function | No | Callback when user exits the flow |
## Customizing the Button
### Button Text
Set the button label by adding text content inside the `` element:
```html theme={null}
Verify My Identity
```
If no text is provided, the button defaults to **"Verify me"**.
### Button Styles
Use the `::part(button)` CSS pseudo-element to style the button to match your brand:
```css theme={null}
urtentic-button::part(button) {
background-color: #ff5722;
color: white;
padding: 12px 24px;
border-radius: 8px;
font-size: 18px;
}
```
## Browser Compatibility
The Urtentic Web SDK is compatible with all modern browsers:
| Browser | Support |
| ------- | ----------------- |
| Chrome | Latest 2 versions |
| Firefox | Latest 2 versions |
| Safari | Latest 2 versions |
| Edge | Latest 2 versions |
For older browsers, the SDK automatically includes polyfills for Web Components.