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

# Troubleshooting Overview

> Diagnose and resolve common ZeroTwo issues quickly.

Most issues with ZeroTwo fall into one of a handful of categories. Work through the quick checklist below before diving into a specific guide — the majority of problems are resolved in under a minute.

## Quick Diagnostic Checklist

Before opening a support ticket, run through this checklist:

* **Check your plan limits.** The most common cause of unexpected behavior is hitting a quota (daily message limit, premium model cap, search limit, etc.). Go to Settings → Account to see current usage.
* **Verify your browser is up to date.** ZeroTwo uses modern browser APIs. Chrome, Firefox, Safari, and Edge should all be on their latest stable release.
* **Refresh the page.** A hard refresh (Cmd/Ctrl+Shift+R) clears cached state and resolves many transient UI issues.
* **Check your network connection.** ZeroTwo requires a stable internet connection. If you're on a slow or unreliable connection, features like voice chat, file uploads, and deep research may time out.
* **Try an incognito / private window.** Browser extensions (especially ad blockers, cookie managers, and privacy tools) can interfere with ZeroTwo's auth flow and tool integrations. Incognito mode disables extensions by default.
* **Still not resolved? Contact support.** Email [reed@zerotwo.ai](mailto:reed@zerotwo.ai) with a description of the issue, your browser/OS, and any error messages you see.

***

## Issue Categories

Use the table below to jump directly to the guide for your issue type.

| Issue Type               | Guide                                                           |
| ------------------------ | --------------------------------------------------------------- |
| Login / account access   | [login-issues](/troubleshooting/login-issues)                   |
| Model slow or timing out | [model-timeouts](/troubleshooting/model-timeouts)               |
| Tool or permission error | [tools-and-permissions](/troubleshooting/tools-and-permissions) |
| File upload failure      | [upload-errors](/troubleshooting/upload-errors)                 |
| Billing / subscription   | [billing-issues](/troubleshooting/billing-issues)               |
| Voice chat problems      | [voice-issues](/troubleshooting/voice-issues)                   |
| Web search problems      | [search-issues](/troubleshooting/search-issues)                 |
| Canvas issues            | [canvas-issues](/troubleshooting/canvas-issues)                 |
| Common error messages    | [common-error-messages](/troubleshooting/common-error-messages) |

***

## Troubleshooting Guides

<CardGroup cols={2}>
  <Card title="Login Issues" icon="shield" href="/troubleshooting/login-issues">
    Password resets, OAuth failures, 2FA problems, and invite issues.
  </Card>

  <Card title="Model Timeouts" icon="alert-triangle" href="/troubleshooting/model-timeouts">
    Slow responses, timeouts, and model unavailability.
  </Card>

  <Card title="Tools & Permissions" icon="settings" href="/troubleshooting/tools-and-permissions">
    Agent Mode, connector scopes, and tool permission errors.
  </Card>

  <Card title="Upload Errors" icon="file" href="/troubleshooting/upload-errors">
    File too large, unsupported type, upload timed out.
  </Card>

  <Card title="Billing Issues" icon="credit-card" href="/troubleshooting/billing-issues">
    Payment failures, plan not updating, unexpected charges.
  </Card>

  <Card title="Voice Issues" icon="mic" href="/troubleshooting/voice-issues">
    Microphone permission, choppy audio, disconnections.
  </Card>

  <Card title="Search Issues" icon="search" href="/troubleshooting/search-issues">
    Search pill grayed out, missing sources, quota usage.
  </Card>

  <Card title="Canvas Issues" icon="layers" href="/troubleshooting/canvas-issues">
    Canvas not opening, wrong editor type, export failures.
  </Card>

  <Card title="Common Error Messages" icon="info" href="/troubleshooting/common-error-messages">
    Full reference for every ZeroTwo error message.
  </Card>
</CardGroup>

***

## Still Need Help?

If none of the guides above resolve your issue, reach out to ZeroTwo support directly:

* **Email:** [reed@zerotwo.ai](mailto:reed@zerotwo.ai)
* **Website:** [zerotwo.ai](https://zerotwo.ai)

When contacting support, include:

* A description of the issue and steps to reproduce it
* Your browser name and version
* Your operating system
* Any error messages shown on screen
* Screenshots if applicable