> ## 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 Intelligence

> Configure intelligent passkey behavior and customize adoption strategies with data-driven decision rules.

**Passkey Intelligence** is the core decision and prediction engine that optimizes passkey adoption through customizable, data-driven rules tailored to your specific use case.

<Frame>
  <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/THsuaaHmn1I" title="Passkey Intelligence Configuration" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## Example Use Cases

<a id="2-third-party-password-manager-behavior" />

### 1. Third-Party Password Manager Behavior

**Define how the system handles password managers like Bitwarden**

**Scenario**: User has Bitwarden passkey on Machine 1, accesses from Machine 2

* System assumes Bitwarden is synced across devices
* After 2 failed attempts, assumes Bitwarden not installed
* Stops offering passkey login on third attempt
* Provides fallback authentication instead

<Info>
  This experimental behavior learns from user patterns to improve experience while maintaining high adoption rates.
</Info>

<a id="3-cross-browser-passkey-handling" />

### 2. Cross-Browser Passkey Handling

**Manage passkeys across different browsers on same device**

**Example**: Windows user with passkey in Chrome opens Firefox

* System attempts to use existing passkey twice
* After 2 failures, assumes different machine (not same Windows device)
* Offers fallback login for convenient access
* User can create new passkey after authentication

<a id="4-cross-device-authentication" />

### 3. Cross-Device Authentication

**Control QR code and Bluetooth proximity features**

* Enable/disable cross-device authentication
* Manage QR code scanning options
* Control Bluetooth proximity requirements
* Balance security with user convenience

<a id="1-hardware-security-key-control" />

<a id="5-credential-manager-restrictions" />

## Authenticator acceptance

[Authenticator Policies](/corbado-connect/features/authenticator-policies) define which providers and security-key models qualify for enrollment, including AAGUID rules and attestation requirements. Passkey Intelligence controls when and how passkey options are offered. Offering an external authenticator in the UI does not establish that its credential meets the enrollment policy.

## Trade-offs and Optimization

### Balancing Act

Configure the balance between:

* **High Adoption**: Maximize passkey usage
* **User Experience**: Minimize friction and confusion
* **Enrollment Requirements**: Coordinate the experience with your [Authenticator Policies](/corbado-connect/features/authenticator-policies)
* **Technical Constraints**: Handle device limitations

### Customization Benefits

* **Industry-Specific**: Tailor enrollment offers to your customer journeys
* **User-Specific**: Different rules for different segments
* **Progressive Enhancement**: Evolve rules based on data
* **A/B Testing**: Compare different approaches

<Tip>
  Work with a Corbado adoption engineer to fine-tune your Passkey Intelligence configuration based on your specific traffic patterns and user behavior.
</Tip>

## Best Practices

* **Start Conservative**: Begin with fewer restrictions
* **Monitor Impact**: Track adoption and success rates
* **Iterate Gradually**: Make incremental adjustments
* **Document Decisions**: Keep records of rule rationale
* **Regular Reviews**: Reassess rules as ecosystem evolves

<Note>
  Passkey Intelligence is crucial for maximizing adoption while maintaining security and user experience standards. The system continuously learns and improves based on user behavior patterns.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.