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

# Troubleshoot Common Veyda Issues

> Resolve sync errors, missing insights, notification failures, and login problems with step-by-step troubleshooting guides for the Veyda app.

Most Veyda issues fall into a handful of predictable categories and can be resolved in a few minutes without contacting support. Work through the relevant section below from top to bottom — each step builds on the previous one and covers the most common root causes first.

<AccordionGroup>
  <Accordion title="Device not syncing">
    When a connected device stops sending data to Veyda, your insights may become stale or stop updating entirely. Follow these steps to restore the connection:

    <Steps>
      <Step title="Check device status and charge level">
        Make sure your wearable or health device is powered on and has sufficient battery. Devices with critically low battery often suspend background data transmission. Charge your device to at least 20% and wait a few minutes before trying again.
      </Step>

      <Step title="Verify Bluetooth is enabled">
        If your device connects directly via Bluetooth (rather than through a companion app like Apple Health or Google Fit), confirm that Bluetooth is turned on in your phone's system settings. Toggle it off and back on to force a fresh scan for nearby devices.
      </Step>

      <Step title="Re-authorize the connection in Veyda">
        Open **Settings → Connections**, find the affected device or app, and tap it to view the connection detail screen. If the status shows an error or expired authorization, tap **Re-connect** and complete the authorization flow. You may be redirected to the device manufacturer's app or a permissions screen.
      </Step>

      <Step title="Force a manual sync">
        From the Connections page, tap **Sync Now** next to the affected source. Veyda will attempt to pull the latest data immediately. Check the Insights feed after 60 seconds to confirm data is flowing.
      </Step>
    </Steps>

    If none of the steps above restore the sync, try disconnecting the source entirely and adding it again from scratch via **Settings → Connections → Add Connection**.
  </Accordion>

  <Accordion title="Missing or outdated insights">
    If your Insights feed looks empty or hasn't refreshed recently, the cause is usually insufficient data history or a sync gap.

    <Steps>
      <Step title="Check your data history">
        Most insight categories require at least 7 consecutive days of data to generate a reliable result. Recovery scores, HRV trends, and sleep staging analysis need this minimum window. If you recently created your account or connected a new data source, insights for those categories will appear once enough data has accumulated.
      </Step>

      <Step title="Confirm all data sources are actively syncing">
        Go to **Settings → Connections** and review the sync status for each connected source. Any source showing an error or a last-sync timestamp older than a few hours may have a connection issue. See the **Device not syncing** section above to restore it.
      </Step>

      <Step title="Refresh the Insights feed">
        Pull down on the Insights screen to trigger a manual refresh. This forces Veyda to re-evaluate your available data and regenerate any insights that may be queued but not yet displayed.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Notifications not arriving">
    Veyda sends notifications for daily summaries, goal completions, and anomaly alerts. If you're not receiving them, the issue is typically a permissions or settings mismatch.

    <Steps>
      <Step title="Check notification permissions in your phone settings">
        * **iOS:** Go to **Settings → Notifications → Veyda** and confirm that **Allow Notifications** is enabled. Set the alert style to **Banners** or **Alerts** so notifications appear on screen.
        * **Android:** Go to **Settings → Apps → Veyda → Notifications** and verify that notifications are enabled. Check that the notification category you expect (such as Health Alerts or Daily Summary) is not individually silenced.
      </Step>

      <Step title="Review notification settings inside Veyda">
        Open **Settings → Notifications** in the Veyda app and confirm that the specific notification types you want are toggled on. Each category — daily summaries, goal alerts, and anomaly notifications — has its own toggle.
      </Step>

      <Step title="Check Quiet Hours">
        Veyda's Quiet Hours feature suppresses all notifications during a time window you define. Go to **Settings → Notifications → Quiet Hours** and confirm that the scheduled quiet window does not overlap with the times you expect to receive alerts. Disable Quiet Hours temporarily to test if this is the cause.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Login and account issues">
    <Steps>
      <Step title="Forgot your password">
        On the Veyda login screen, tap **Forgot Password** below the sign-in button. Enter the email address associated with your account and tap **Send Reset Link**. Check your inbox — including your spam folder — for a password reset email and follow the link to create a new password. Reset links expire after 30 minutes.
      </Step>

      <Step title="Single sign-on (SSO) not working">
        If you sign in with Apple or Google and encounter an error, make sure you're using the same provider you used when you originally created your account. Switching providers requires contacting support to merge or reassign your account. Reach out to [support@veyda.com](mailto:support@veyda.com) with your registered email address and a description of the error.
      </Step>

      <Step title="Account locked after failed login attempts">
        Veyda temporarily locks accounts after several consecutive failed login attempts to protect against unauthorized access. If your account is locked, wait 30 minutes and try again with the correct credentials. If you've forgotten your password, use the **Forgot Password** flow described above rather than retrying the wrong password and extending the lockout.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="App crashes or performance issues">
    If the Veyda app is crashing, running slowly, or behaving unexpectedly, work through these steps before contacting support.

    <Steps>
      <Step title="Update the Veyda app">
        Open the App Store or Google Play and check whether a Veyda update is available. App crashes are often caused by bugs fixed in a subsequent release. Install the latest version and relaunch the app.
      </Step>

      <Step title="Restart the app">
        Force-quit Veyda completely — swipe it away from your recent apps list — and reopen it. This clears any in-memory state that may have caused the crash without affecting your data or settings.
      </Step>

      <Step title="Clear the app cache (Android only)">
        On Android, cached data can occasionally become corrupted and cause instability. Go to **Settings → Apps → Veyda → Storage → Clear Cache**. This removes temporary files only and does not affect your account data or synced health metrics.
      </Step>
    </Steps>

    If the app continues to crash after these steps, note what you were doing when the crash occurred and contact support with that context — it helps us reproduce and fix the issue faster.
  </Accordion>
</AccordionGroup>

<Note>
  If you've worked through the relevant steps and still can't resolve your issue, our support team is ready to help. Email us at **[support@veyda.com](mailto:support@veyda.com)** with a description of the problem, your device model, operating system version, and any error messages you've seen.
</Note>