---
title: "Screens & States"
url: "https://developer.incode.com/design-and-ux/id-capture-screens-and-states/"
section: "design-and-ux"
group: "Module Customization / ID Capture Design"
version: "v1.1"
status: "live"
---
# Screens & States

A complete view of all screens the user may encounter during the ID Capture experience. Each state includes a brief description and optionally a link to its source in Figma or screen-specs.

***

## Tutorial

Introductory screen shown before the camera opens. It sets expectations (flat surface, good lighting, show full ID, avoid glare) and include an short animation.

<Image align="center" border={false} src="https://developer.incode.com/assets/8f2f7b0e005808c9aa2cc235d212d462.png" />

<br />

## Permission Screens

Shown when camera permissions have not been granted. Includes pre-permission context, OS-specific instructions, and fallback steps if the system dialog is dismissed.

<Image align="center" border={false} src="https://developer.incode.com/assets/783a8d02983152c1f4d76f788f07dc7a.png" />

<br />

## Auto Capture

Primary capture method for the **ID Capture**. The camera view is active and the system monitors real-time quality gates (glare, cut-off, blur, edge visibility, barcode/MRZ presence if applicable). When all thresholds are met, the photo is captured automatically.

<Image align="center" border={false} src="https://developer.incode.com/assets/70794568e39a4daefae7c8d24573fd05.png" />

<br />

## Manual Capture (Fallback)

If auto-capture doesn’t trigger (e.g., complex lighting, slow device, user delay) then after a timeout a manual capture button is shown and user can tap to take photo themselves.

<Image align="center" border={false} src="https://developer.incode.com/assets/b30b2b420cfd219391c641b9e51121a9.png" />

<br />

## Feedback Messages (Real-Time Guidance)

While the camera is active, real-time messages guide the user to correct issues such as: “Move closer”, “Avoid glare”, “Show all four corners”, “Flip to back side”, etc.

<Image align="center" border={false} src="https://developer.incode.com/assets/ff215c22f69f4db7cedad4df5f597172.png" />

<br />

## Analyzing

After capture (front/back) the images are being uploaded and processed (OCR, authenticity check). During this stage the UI prevents further interaction and shows progress.

<Image align="center" border={false} src="https://developer.incode.com/assets/fa345afc8c9904464a946ccd91761188.png" />

<br />

## Success

When the images pass quality checks and upload/processing succeeds, the user sees a success screen. The user can proceed to the next verification step without additional input.

<Image align="center" border={false} src="https://developer.incode.com/assets/c1ec9ef8cc2f4ccdfdba8f0228e947b1.png" />

<br />

## Retry Errors

Displayed when **ID Capture** fails but attempts remain. Provides specific corrective guidance and a retry CTA. Attempts reset after a successful capture.

<Image align="center" border={false} src="https://developer.incode.com/assets/a6b0f23b652b5df03a6bb8fd98a6a590.png" />

<br />

<br />

## Document Not Accepted Errors

Document Not Accepted is a screen shown when the user’s ID can’t be verified—for example, due to an expired ID document or an unsupported document type. It displays a list of accepted documents for that country so the user can see which types are valid for verification.

<Image align="center" border={false} src="https://developer.incode.com/assets/93e5036d6229aa8a1c49bf40b06de4dc.png" />

<br />

## Final Errors (No Attempts Remaining)

When all permitted attempts are exhausted, this screen indicates that manual review will follow (or next steps if applicable).

<Image align="center" border={false} src="https://developer.incode.com/assets/c96ffa81f961dc85fc9985d3f6920eac.png" />

<br />

## Connection Error

Displays when connectivity is lost during capture or upload. Users can retry once a stable connection is restored.

<Image align="center" border={false} src="https://developer.incode.com/assets/dc0cedc60d1e935e0d280dbdf179e514.png" />