Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Integrate Didit verification into your web application. We offer multiple methods to fit your architecture and user experience requirements.

Choose your integration method: From quick no-code iframes to full programmatic control with our JavaScript SDK.


Integration Methods

MethodStatusSetup TimeBest For
JavaScript SDK✅ Available3 minutesFull control, React/Vue/Angular/NextJS/Nuxt/Svelte
InContext (Iframe)✅ Available< 1 minuteQuick setup, embedded experience
Redirect✅ Available5 minutesCross-device flows

Recommendation: For production apps, we recommend the JavaScript SDK for the best user experience and full programmatic control. Use InContext iframe for the quickest setup, or Redirect when cross-device verification is needed.


JavaScript SDK

The Didit JavaScript SDK provides a programmatic way to integrate verification with full control over the user experience. Key Features:
  • Session management and event callbacks
  • React, Vue, Angular, NextJS, Nuxt, Svelte and vanilla JS support
  • Full TypeScript support
  • Modal & inline modes
Quick Start:
import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with URL (from your backend or UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/session-token'
});
Full JavaScript SDK Documentation

InContext (Iframe)

Embed the verification flow directly within your application using an iframe. Seamless experience without redirecting users away from your site. Key Features:
  • UniLink (no backend required) - setup in < 1 minute
  • API Session (with backend) - full customization
  • Modal and inline implementations
  • React component examples
Quick Start:
<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; fullscreen; autoplay; encrypted-media"
></iframe>
Full InContext Documentation

Redirect

Redirect users to the Didit-hosted verification page. After completion, users return to your callback URL. Key Features:
  • Maximum browser compatibility
  • Cross-device verification support
  • Simple integration
  • Works when iframe camera access is problematic
Quick Start:
// After creating a session via your backend
window.location.href = verificationUrl;
Full Redirect Documentation

Comparison

FeatureJavaScript SDKInContext (Iframe)Redirect
Setup Time3 min< 1 min5 min
Backend RequiredOptionalOptionalYes
Stays on Your Domain✅ Yes✅ Yes❌ No
Cross-Device Support✅ Yes✅ Yes✅ Yes
Full Programmatic Control✅ Yes⚠️ Limited❌ No
Event Callbacks✅ Real-time⚠️ postMessage❌ Callback only
White-label✅ Yes✅ Yes✅ Yes
Browser CompatibilityAllAllAll

Configuration

Required Iframe Permissions

For InContext iframe integrations, always include these permissions:
allow="camera; microphone; fullscreen; autoplay; encrypted-media"

Example Repositories

Iframe Example

UniLink + API Session iframe examples

Full Next.js Demo

Full Next.js integration