> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/authentication/1kosmos-mobile-application/faqs.md). # FAQs ### Getting started
What is the 1Kosmos app? 1Kosmos is a consumer identity management app that replaces passwords with biometrics, QR codes, and verifiable credentials. It also acts as a digital wallet for storing identity documents and credentials issued by trusted authorities.
How many accounts can I link to one device? You can link multiple accounts to a single device. The home screen shows all linked accounts and lets you switch between them. Each account has its own OTP and authentication state.
### Authentication
Can I still authenticate if I'm offline? Yes. The **Account OTP** (visible on the app home screen) works offline. Push notifications require an internet connection, but the Account OTP is always available as a fallback.
What happens after 10 wrong PIN attempts? On both Android and iOS, 10 consecutive incorrect PIN attempts will automatically reset the app. All accounts and wallet data on the device will be permanently deleted. * **Android** — PIN or biometric failures count toward the limit. * **iOS** — Only PIN failures count (biometric checks are validated by the OS). Make sure to back up your recovery mnemonic before this happens.
What is LiveID and when is it required? LiveID is a real-time selfie captured by the front camera to confirm liveness — that a real person is present, not a photo or recording. It is required: * Before enrolling your Social Security Number * During high-assurance identity verification flows * For wallet restoration if previously enrolled
Why do I have to authenticate every time I open the app? Authentication on every app launch protects your accounts and wallet from unauthorized access. You can authenticate using your PIN or biometrics — biometrics are typically faster and recommended.
Biometric authentication keeps failing. What should I do? Biometric failures usually happen when you use an unregistered finger or face. * Make sure you're using the same fingerprint or face you enrolled with * Clean the sensor or front camera and ensure good lighting for face authentication * If it still fails, use your PIN to log in instead
How do I change my account password from the mobile app? **Prerequisite:** To reset your password using your mobile app, make sure to turn the **Enable users to reset password through Mobile App** slider ON under **Authentication > Reset Password** on the AdminX interface. To reset your account password: 1. On the home screen of your mobile app, tap **Reset Password** below the account for which you want to reset the password. 2. In the Reset Password screen that appears, tap the new password, and then tap **OK**.
### Identity & wallet
What documents can I enroll? You can enroll: * Driver's License (front + back + selfie) * Passport (with optional RFID verification) * Social Security Number {% hint style="warning" %} SSN enrollment requires a LiveID and at least one of Driver's License or Passport to be enrolled first. {% endhint %}
What is a recovery mnemonic and why do I need it? It's a 12-word phrase that acts as the master key to your identity wallet. If you lose your device or reinstall the app, this phrase is the only way to recover your wallet and enrolled identity documents. Save it somewhere safe immediately after setup. See Backup & recovery for guidance.
What are verifiable credentials? Verifiable credentials are digital credentials that can be added, presented, and deleted from your 1Kosmos wallet. They are stored on your device and can be shared with relying parties as part of identity verification flows.
What is Identity Assurance Level (IAL)? IAL is a baseline score reflecting how thoroughly your identity has been verified. It's based on the biometric assets and identity documents you've enrolled. Higher IAL is unlocked as you enroll more assets. You can check your IAL in the app menu, beneath your User Profile.
Where do I find my 12-word recovery mnemonic in the app? Your recovery mnemonic is available from the app menu. * Open **Menu** * Tap Recovery Mnemonic * Tap Next to view those phrases Save this phrase somewhere safe — it's the only way to recover your wallet and enrolled identity documents.
How do I transfer my account to another device using a QR code? For steps on how to transfer, see [Account Management](/authentication/1kosmos-mobile-application/application-capabilities/account-management.md#transfer-accounts-to-a-new-device)
### Troubleshooting
I completed onboarding but never received the invite email. What should I do? If the onboarding invite email doesn't arrive: * Check your spam or junk folder * Confirm the email address on file with your organization is correct * Allow a few minutes for delivery If it still hasn't arrived, contact your administrator to have them resend the invite.
I'm not receiving push notifications. What should I do? Check the following: 1. Notification permissions are enabled for the 1Kosmos app in device settings 2. Your device has Google Play Services (Android only) 3. You have an active internet connection If sideloading the APK on a non-GMS Android device, push notifications are not available — use Workstation OTP instead.
My account shows as orphaned. What does that mean? An orphaned account appears when an administrator has unlinked your device in the AdminX portal. From app version v1.10.90 onwards, orphaned accounts are automatically removed when the app launches, and you'll be notified. Contact your administrator to re-onboard.
How do I report an issue or get support? Tap the help icon at the bottom right of the home screen, or go to **Menu → Need help?**. Describe your issue, attach up to 3 screenshots, and submit. A support ticket will be created automatically for the 1Kosmos team.
The app is asking me to update — what does that mean? Starting with v1.20.60, the app has a force upgrade mechanism for security and feature consistency. When triggered: * Tap **Update Now** to redirect to your app store * Tap **Later** to defer for 24 hours Updating is recommended to ensure you have the latest security patches and features.
I lost my device. Can I recover my identity? Yes — if you saved your 12-word recovery mnemonic. 1. Install the 1Kosmos app on a new device 2. Tap **Restore** on the Welcome screen 3. Choose **Recover Identity Wallet** 4. Enter your 12-word phrase If you don't have the mnemonic, contact your administrator. They may be able to re-onboard your account, but previously stored credentials and biometric assets cannot be recovered.
Can I uninstall and reinstall the app safely? Only if you have your 12-word recovery mnemonic saved. Uninstalling permanently deletes all locally stored accounts and wallet data. The mnemonic is the only way to restore them.
How do I enable push notifications on my iPhone? Push notifications on iOS require permission for the 1Kosmos app. * When you first install and open the app, grant notification permission when prompted * If you previously declined, go to **Settings → Notifications → 1Kosmos** on your device and enable **Allow Notifications** Without this permission, the app can't display push-based authentication requests. > **Note:** iOS shows the notification permission prompt only once — during the first launch after install. If you dismiss or decline it then, the app won't ask again.
Account linking failed. What should I do? If linking your account to the device doesn't complete, contact your administrator to confirm your account status and, if needed, have your device re-onboarded.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.1kosmos.com/authentication/1kosmos-mobile-application/faqs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.