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

# Login to Smartbills

> Access your Smartbills account on web, iOS, and Android devices

## Overview

Access your Smartbills account from anywhere - web browser, iOS app, or Android app. This guide covers all login methods and troubleshooting common issues.

## Web Application

### Standard Login

<Steps>
  <Step title="Navigate to Smartbills">
    Go to [app.smartbills.io](https://app.smartbills.io)
  </Step>

  <Step title="Enter Credentials">
    * Enter your **email address**
    * Enter your **password**
    * (Optional) Check **Remember me** to stay logged in
  </Step>

  <Step title="Sign In">
    Click the **Sign In** button
  </Step>
</Steps>

### Alternative Login Methods

<Tabs>
  <Tab title="Google Sign-In">
    1. Click **Sign in with Google**
    2. Select your Google account
    3. Authorize Smartbills if prompted
    4. You're logged in!
  </Tab>

  <Tab title="Apple Sign-In">
    1. Click **Sign in with Apple**
    2. Authenticate with your Apple ID
    3. Choose to share or hide your email
    4. Complete sign-in
  </Tab>

  <Tab title="SSO (Enterprise)">
    **For Enterprise customers with Single Sign-On:**

    1. Click **Sign in with SSO**
    2. Enter your company email domain
    3. You'll be redirected to your company's login page
    4. Authenticate with your company credentials
    5. You'll be redirected back to Smartbills

    <Note>
      SSO must be configured by your IT administrator. Contact them if you have issues.
    </Note>
  </Tab>
</Tabs>

## Mobile App Login

### iOS

<Steps>
  <Step title="Open the App">
    Tap the Smartbills icon on your home screen
  </Step>

  <Step title="Choose Login Method">
    **Email & Password:**

    * Enter your email
    * Enter your password
    * Tap **Sign In**

    **Or use:**

    * **Sign in with Apple** (faster with Face ID/Touch ID)
    * **Sign in with Google**
  </Step>

  <Step title="Enable Biometrics (Optional)">
    After first login, you'll be prompted to enable Face ID or Touch ID for faster future logins

    Tap **Enable** to use biometric authentication
  </Step>
</Steps>

### Android

<Steps>
  <Step title="Launch Smartbills">
    Tap the Smartbills app icon
  </Step>

  <Step title="Sign In">
    **Email & Password:**

    * Enter your email address
    * Enter your password
    * Tap **Sign In**

    **Or use:**

    * **Continue with Google** (one-tap sign in)
  </Step>

  <Step title="Enable Fingerprint (Optional)">
    Enable fingerprint authentication for quick access:

    * Tap **Enable Fingerprint**
    * Authenticate with your fingerprint
    * Future logins will use fingerprint
  </Step>
</Steps>

## Biometric Authentication

### Set Up Biometric Login

For faster, more secure access:

<Tabs>
  <Tab title="iOS (Face ID / Touch ID)">
    **Initial Setup:**

    1. Login with email and password
    2. When prompted, tap **Enable Face ID** or **Enable Touch ID**
    3. Authenticate to confirm

    **Enable Later:**

    1. Go to Settings → Security
    2. Toggle on **Face ID** or **Touch ID**
    3. Authenticate to confirm

    **Using Face ID/Touch ID:**

    * Open the app
    * Face ID activates automatically
    * Or touch the fingerprint sensor
    * Instantly logged in!
  </Tab>

  <Tab title="Android (Fingerprint)">
    **Initial Setup:**

    1. Login with email and password
    2. When prompted, tap **Enable Fingerprint**
    3. Touch your fingerprint sensor to confirm

    **Enable Later:**

    1. Go to Settings → Security & Privacy
    2. Enable **Fingerprint Login**
    3. Authenticate with fingerprint

    **Using Fingerprint:**

    * Open the app
    * Touch fingerprint sensor
    * Logged in instantly!
  </Tab>
</Tabs>

<Check>
  **Recommended**: Enable biometric authentication for the best balance of security and convenience.
</Check>

## Stay Logged In

### Web Browser

**"Remember Me" Option:**

* Check this box to stay logged in
* Duration: 30 days
* Works only on trusted devices
* Cleared when you clear browser cookies

<Warning>
  Only use "Remember Me" on your personal devices, never on shared or public computers.
</Warning>

### Mobile App

**Automatic Login:**

* You stay logged in by default
* App remembers your session
* Use biometrics for quick access
* You can manually log out from Settings

**Session Duration:**

* Sessions last 90 days by default
* Extended to 180 days with biometrics enabled
* Sessions expire if not used for 90 days

## Multi-Device Access

You can be logged in on multiple devices simultaneously:

* ✅ Web browser(s)
* ✅ iPhone/iPad
* ✅ Android phone/tablet
* ✅ Multiple browsers/devices

All devices sync in real-time!

<Tip>
  **Working across devices?** Changes made on one device appear instantly on all other devices where you're logged in.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Forgot Password" icon="key">
    If you can't remember your password:

    1. Click/tap **Forgot Password?** on the login screen
    2. Enter your email address
    3. Click **Send Reset Link**
    4. Check your email for a password reset link
    5. Click the link and create a new password
    6. Return to login with your new password

    See: [Reset Your Password](/help-center/account/reset-password)
  </Accordion>

  <Accordion title="Incorrect Email or Password" icon="circle-exclamation">
    **Check these common issues:**

    * **Email typo**: Verify email address is correct
    * **Caps Lock**: Password is case-sensitive
    * **Extra spaces**: Remove spaces before/after email or password
    * **Wrong account**: You might have multiple accounts
    * **Account not verified**: Check email for verification link

    **Still can't login?**
    Use the **Forgot Password** link to reset your password.
  </Accordion>

  <Accordion title="Account Locked" icon="lock">
    After 5 failed login attempts, your account is temporarily locked for security.

    **What to do:**

    1. Wait 15 minutes, then try again
    2. Or click **Forgot Password** to reset
    3. Contact [support@smartbills.io](mailto:support@smartbills.io) if urgent

    **Prevent lockouts:**

    * Enable biometric authentication
    * Use a password manager
    * Reset password if unsure
  </Accordion>

  <Accordion title="Two-Factor Authentication Issues" icon="shield">
    If you have 2FA enabled and can't login:

    **Can't access 2FA code:**

    1. Use backup codes you saved when setting up 2FA
    2. Click **Use backup code** on 2FA screen
    3. Enter one of your backup codes

    **Lost backup codes:**

    1. Click **I don't have access to my authenticator**
    2. Verify your identity via email
    3. Temporarily disable 2FA
    4. Login and re-enable 2FA

    See: [Two-Factor Authentication](/help-center/account/two-factor-auth)
  </Accordion>

  <Accordion title="SSO Not Working" icon="building">
    **For Enterprise SSO users:**

    **Common issues:**

    1. **Wrong domain**: Ensure you enter your company email domain correctly
    2. **Not configured**: SSO must be set up by your IT admin
    3. **Session expired**: Try again from the beginning
    4. **Browser issues**: Clear cache or try different browser

    **Contact:**

    * Your IT administrator for SSO issues
    * Smartbills support for technical problems
  </Accordion>

  <Accordion title="'Email Not Verified' Error" icon="envelope">
    You must verify your email before logging in:

    **Steps:**

    1. Check your email inbox for verification email from Smartbills
    2. Click the verification link
    3. Return to login page and sign in

    **Didn't receive email?**

    1. Check spam/junk folder
    2. Click **Resend verification email** on login page
    3. Add [noreply@smartbills.io](mailto:noreply@smartbills.io) to your contacts
    4. Wait a few minutes for email to arrive
  </Accordion>

  <Accordion title="Mobile App Won't Let Me Login" icon="mobile">
    **iOS/Android app login issues:**

    **Try these solutions:**

    1. **Update the app** to the latest version
    2. **Check internet connection** (WiFi or cellular data)
    3. **Force close and reopen** the app
    4. **Clear app cache** (Android: Settings → Apps → Smartbills → Clear Cache)
    5. **Reinstall the app** (your data is safe in the cloud)
    6. **Try web login** to verify your credentials work

    **Still not working?**
    Contact [support@smartbills.io](mailto:support@smartbills.io) with:

    * Device model and OS version
    * App version
    * Screenshot of error (if any)
  </Accordion>

  <Accordion title="Browser Compatibility Issues" icon="browser">
    Smartbills works best on modern browsers:

    **Supported browsers:**

    * ✅ Chrome (latest 2 versions)
    * ✅ Firefox (latest 2 versions)
    * ✅ Safari (latest 2 versions)
    * ✅ Edge (latest 2 versions)

    **If you have issues:**

    1. Update your browser to the latest version
    2. Clear browser cache and cookies
    3. Disable browser extensions temporarily
    4. Try incognito/private mode
    5. Try a different browser
  </Accordion>
</AccordionGroup>

## Security Tips

### Protect Your Account

<Steps>
  <Step title="Use a Strong Password">
    * At least 12 characters
    * Mix of upper/lowercase, numbers, symbols
    * Avoid common words or personal info
    * Don't reuse passwords from other sites
  </Step>

  <Step title="Enable Two-Factor Authentication">
    Add an extra layer of security with 2FA. [Learn how](/help-center/account/two-factor-auth)
  </Step>

  <Step title="Be Cautious on Public WiFi">
    * Avoid logging in on public WiFi when possible
    * Use a VPN if you must use public networks
    * Always verify you're on the real Smartbills website
  </Step>

  <Step title="Check for HTTPS">
    Always ensure the URL starts with `https://app.smartbills.io`

    Look for the padlock icon in your browser
  </Step>

  <Step title="Log Out on Shared Devices">
    Always log out when using:

    * Public computers
    * Shared devices
    * Someone else's device
  </Step>

  <Step title="Review Login Activity">
    Regularly check your login history:

    1. Go to Settings → Security
    2. View **Recent Activity**
    3. Look for unfamiliar devices or locations
    4. Revoke access to unknown devices
  </Step>
</Steps>

### Recognize Phishing Attempts

<Warning>
  **Smartbills will NEVER:**

  * Ask for your password via email
  * Request your credit card details via email
  * Send links to login pages from unknown domains
  * Ask you to "verify" your account via suspicious links
</Warning>

**If you receive a suspicious email:**

1. Don't click any links
2. Don't download attachments
3. Forward to [security@smartbills.io](mailto:security@smartbills.io)
4. Delete the email

## Logout

### Web

1. Click your profile icon (top right)
2. Select **Log Out**
3. Confirm if prompted

### Mobile

1. Go to Settings or Profile tab
2. Scroll to bottom
3. Tap **Log Out**
4. Confirm logout

<Tip>
  **Quick logout tip**: You can also log out from Settings → Account → Log Out on all platforms.
</Tip>

## Session Management

### View Active Sessions

See all devices where you're logged in:

1. Go to **Settings** → **Security** → **Active Sessions**
2. View list of all active sessions with:
   * Device type (Web, iOS, Android)
   * Location (approximate)
   * Last active time
   * IP address

### Revoke Sessions

Remove access from specific devices:

1. Find the session in your active sessions list
2. Click/tap **Revoke Access** or trash icon
3. Confirm the action
4. That device will be logged out immediately

<Warning>
  **Log out everywhere**: If you suspect unauthorized access, use **Log Out All Devices** to immediately end all sessions.
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card title="Set Up Two-Factor Auth" icon="shield" href="/help-center/account/two-factor-auth">
    Add extra security to your account
  </Card>

  <Card title="Update Your Profile" icon="user" href="/help-center/account/update-profile">
    Customize your account settings
  </Card>

  <Card title="Upload an Expense" icon="receipt" href="/guides/web-app/expenses/upload-expense">
    Start tracking your expenses
  </Card>

  <Card title="Mobile App Setup" icon="mobile" href="/guides/mobile/install-and-login">
    Get started on iOS or Android
  </Card>
</CardGroup>

## Need Help?

* **Can't login?** Try [Reset Password](/help-center/account/reset-password)
* **Account issues?** Email [support@smartbills.io](mailto:support@smartbills.io)
* **Security concerns?** Email [security@smartbills.io](mailto:security@smartbills.io)
* **Live Chat**: Available in the app (after login)