If you're having trouble setting up or using your passkey, this guide will help you resolve common issues.

Before you start, here are steps that commonly help:

• Android: Open in Chrome
• iOS: Open in Safari
• Enable screen lock on your device (PIN, fingerprint, or Face ID)
• Update your device and browser to the latest version
• Restart phone - sometimes this helps as well

Common Error Messages

"Passkey setup was blocked" (NotAllowedError)

This error occurs when your browser or device blocks passkey creation. This is the most common issue and can happen for several reasons.

Android Devices

Try these solutions in order:

1. Exit Incognito/Private mode - Use regular Chrome instead
2. Sign into Google account - Make sure you're signed into a Google account in Chrome
3. Enable phone screen lock - Go to Settings > Security and set up a PIN, pattern, or biometric lockso
4. Turn off VPN temporarily - Some VPN or privacy apps can interfere with passkeys
5. Update your apps - Update Google Play Services and Chrome to the latest versions

⚠️ Important Note for Budget Android Devices: Lower-end Android devices (like some Redmi, Realme, or other budget brands) may require recent security updates for passkeys to work properly. If your device hasn't received security patches in over 6 months, passkey support may be limited even with screen lock enabled.

iOS Devices (iPhone/iPad)