Skip to main content
Location: Settings → Know Your Customer (KYC) → User Interface & SDK

​
Session Timer

The timer stays hidden until the session is close to expiring, so users are not watching a countdown from the moment they start. When it appears depends on the total session length — whether that comes from this dashboard or from sessionLength at token generation: If the threshold would fall in the first half of a very short session, the timer appears at the halfway point instead. In the last 30 seconds it switches to a critical state to make the remaining time unmistakable. Turning Show session timer off still hides it everywhere. The screens it appears on are unchanged: document selection, onboarding, instructions, device selection, and the capture step on desktop and light mobile. It is not shown on email or phone verification, questionnaires, bank verification, the full-screen mobile camera, liveness, eID, photo retake, or the completion screen.
This later-appearing timer is rolling out as an A/B test across the web flow, so only a share of your users see it — the rest keep the timer that counts down from the start of the flow.

​
Document Selection and Back Navigation

While Show document selection is on, users can return to that screen with the Back button at any point they are allowed to go back — including after a document photo has already been taken, so a wrong document type no longer forces them to finish the wrong verification or abandon the session. Picking a different type overwrites the photos captured earlier in that session. With the setting off there is no selection screen to return to, and the document type is inferred from the photo instead.

​
Automatic Country and Document Detection

With this on, the user is not shown a manual country or document selection screen at all. It is the better choice when your users may verify with a document issued somewhere other than where they are — a foreign national onboarding for a job abroad, for instance.
  1. Direct to camera — the user goes straight to the document capture screen.
  2. Auto-detection — the user’s location is detected via IP, and accepted documents for that country are applied.
  3. Scan and recognize — the document is identified from the capture.
  4. Manual fallback — if recognition fails through poor lighting or an unreadable image, the user is asked to select country and document type after all.

​
Localization

  • Default: Localization is enabled automatically.
  • Detection: The system detects the language from the user’s IP address.
  • Limitation: Browser language settings are ignored.
  • Persistence: If the user changes the language mid-verification, that choice is kept for the rest of the session — including when they continue on another device after scanning the QR code or opening an SMS link. This applies regardless of the locale passed when the session was created.
All available locales