> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corbado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Passkey Login: Error States

> This flow describes various error states users may encounter when attempting to sign in using a passkey or traditional credentials in native apps. Understanding these scenarios ensures a smooth user experience by providing clear, actionable error messages and fallback options.

## Error States During User Login

Resilient user login on native app, with visual guidance in all failure scenarios.

These error states are part of a comprehensive [fallback and recovery strategy](https://www.corbado.com/blog/passkey-fallback-recovery) that ensures users can always access their accounts securely, even when passkey authentication encounters issues.

### General Login Errors

Error scenarios, user experience while general login into the application.

<Tabs>
  <Tab title="iOS" />

  <Tab title="Android" />
</Tabs>

<Steps>
  <Step title="Error: no identifier / unrecognised identifier">
    * When user attempts to login with a blank or invalid email/username.
  </Step>

  <Step title="Error: account locked / not found">
    * The email/username does not correspond to an active account, or the account is locked.
  </Step>

  <Step title="Error: system / API error related to lookup">
    * An internal error occurs while looking up the user/account.
  </Step>

  <Step title="Error: general passkey login error">
    * Something went wrong with passkey authentication unrelated to user input.
  </Step>

  <Step title="Error: tried deleted passkey">
    * User attempts login with a credential that has been deleted.
  </Step>

  <Step title="Error: incorrect Username / Password">
    * User provides incorrect login credentials.
  </Step>

  <Step title="Error: critical account error">
    * Major issues with the account status (e.g., banned or under administrative hold).
  </Step>
</Steps>

### Passkey Login Errors

Error scenarios, user experience while login into the application via passkeys.

<Info>
  **Handling Passkey Ceremony Aborts:** When users cancel or abort passkey authentication, it's important to provide clear guidance and retry options. Learn more about best practices for handling [passkey ceremony aborts and fallback strategies](https://www.corbado.com/blog/passkey-fallback-recovery) in our comprehensive guide.
</Info>

<Tabs>
  <Tab title="iOS" />

  <Tab title="Android" />
</Tabs>

<Steps>
  <Step title="Passkey login aborted during OS prompt (first attempt)">
    * User begins the passkey login but cancels or dismisses the OS-native authentication prompt the first time.
    * The system allows the user to try logging in via passkeys or skip and continue with their current login method.
  </Step>

  <Step title="Passkey login aborted during OS prompt (subsequent attempts)">
    * After one or more cancellations in the operating system’s authentication prompt (e.g., second, third, or further attempts), the user continues to see the option to retry, but may receive a supportive message encouraging completion for improved security.
    * User can always opt to skip passkey login and proceed using traditional login credentials.
  </Step>
</Steps>