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. This applies whether the length 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. This includes 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 country or document type discards the document photos and progress from the earlier choice, and the new document starts from its first capture step. The earlier photos are not analysed as part of the new document, so a switch does not produce a false DOC_TYPE_MISMATCH or DOC_SIDE_MISMATCH. Going back and confirming the same country and document type keeps the progress already made. A switch made before the photos have been analysed does not use up a verification attempt. A switch made after analysis counts as an attempt, like any other failed one. Back is not offered during a retake after a failed attempt, because the photos have already been analysed. The user retakes the photos instead. 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. For example, a foreign national onboarding for a job abroad.
  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: iDenfy 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. This includes 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