Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt

Use this file to discover all available pages before exploring further.

Device registration adds a layer of protection against account takeovers by requiring users to verify any new or unrecognized device before they can access their account. When someone signs in from an unfamiliar device, Dynamic detects it and prompts them to confirm ownership through a verification step — blocking unauthorized access even if credentials have been compromised. Device registration is enabled when you set your minimum API version to 2026-04-01. See the API version upgrade guide for details.

​
How it works

​
Returning users on a new device

When an existing user signs in from a device they haven’t used before, the following happens:
  1. Dynamic detects that the device is unrecognized
  2. The user receives an email with a verification link
  3. The user clicks the link to confirm they initiated the sign-in
  4. The device is registered as trusted and the user is granted full access
Once a device is trusted, the user won’t be prompted again on that device.

​
New users

For new users signing up for the first time, device registration happens automatically in the background. There is no additional verification step — the device they sign up from is trusted immediately, keeping the onboarding experience frictionless.

​
Verification methods

Dynamic uses different approaches to identify trusted devices:
  • Cookie-based verification — when cookie-based authentication is enabled, Dynamic uses a secure cookie to identify trusted devices
  • Public key-based verification — when cookies are not enabled, the device proves its identity cryptographically using a public key
Both methods work automatically once device registration is enabled — no additional configuration is needed.

​
Enabling device registration

You can enable device registration from the Dynamic Dashboard under your environment’s security settings.

​
SDK guides

For implementation details, see the guide for your SDK:
  • React SDK — Automatic UI or headless integration
  • React Native SDK — Automatic UI or headless integration for mobile
  • JavaScript SDK — Headless integration with full control over the UI and flow
  • Flutter SDK — Automatic UI or headless integration for Flutter apps
  • Swift SDK — Automatic UI or headless integration for iOS
  • Kotlin SDK — Automatic UI or headless integration for Android

​
Next steps