Skip to main content

Conditional UI Flow (Usernameless Login)

The Conditional UI flow starts without the user entering their username first. This is a usernameless login flow. The platform may offer an eligible subset of credentials selected by the operating system and active providers, for example through iOS QuickType or Android inline or drop-down suggestions. The account is resolved from the selected credential and verified assertion.
Platform support (August 2026): iOS and iPadOS 16+ via performAutoFillAssistedRequests() (not available to native macOS apps), and Android 15+ via PendingGetCredentialRequest in androidx.credentials 1.5.0+, which surfaces credentials in keyboard inline and drop-down suggestions. The Android implementation is currently View-based only, so Compose UIs are not yet covered: the screens below show the iOS experience.
Account resolution: The app does not know which user is signing in until the user selects a passkey. The operating system and active credential providers decide which eligible credentials appear in the suggestion surface.
Product-Native Steps: The blue background indicates optional product-native steps (e.g., verification code, setup PIN, enabling biometrics). PIN and local biometrics are optional features for protecting app access within sessions after passkey authentication completes. Learn more about how passkeys and local biometrics work together to provide both secure remote authentication (passkeys) and convenient app protection (local biometrics).
1

Conditional UI automatically triggered

  • When the user taps the email field, the platform may offer eligible credentials through its suggestion surface.
  • This is usernameless. The app does not yet know which account is signing in.
2

Authenticate using the selected passkey

  • The user taps their passkey from the available options on the keyboard, which identifies them to the system.
  • Upon selection, the system now knows which user account is attempting to authenticate.
3

Authorize credential and verify assertion

  • The platform returns an assertion after authorization with a supported device-unlock method.
  • The app sends the assertion to the relying party, and the user is signed in only after server verification succeeds.
4

App PIN setup

  • After successful passkey authentication, the user is signed in and is asked to set up PIN.
5

Enable local biometric for app login

  • User is allowed to enable/disable local biometric app login (provided as product feature).
The server still decides whether login succeeds. An active provider may surface an eligible credential the server no longer accepts, so device authorization does not guarantee login. Supported WebAuthn Signal API reconciliation can reduce this mismatch but cannot prove what a provider stores or changes.

Acceptance criteria

Platform-dependent: Assess this enhancement only where the operating system, credential service and app UI technology support field-linked credential suggestions. Current Android guidance documents this experience for Android 15+ and View objects; implementations using other UI technologies should be assessed against the current platform capability rather than assumed to qualify.

References