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

# FAQ

> Common questions and troubleshooting

## Common Issues

<AccordionGroup>
  <Accordion title="Test fails with 'Element not found'">
    **Fix:** Make test description more specific. Instead of "Click submit", use "Click the blue Submit button at bottom of form".

    AI needs clear targeting. Add unique identifiers in descriptions.
  </Accordion>

  <Accordion title="Test works in dashboard but fails in CI">
    **Fix:** Check environment variables. Add secrets (API keys, auth tokens) in dashboard Settings → Environment.

    Also verify base URL matches your staging/production environment.
  </Accordion>

  <Accordion title="Generated code has wrong assertions">
    **Fix:** Be explicit in test description. Say "Verify order total equals \$49.99" not just "Check total".

    Re-run test generation with clearer requirements.
  </Accordion>

  <Accordion title="Browser session times out">
    **Fix:** Tests have 5-minute timeout. Break long flows into multiple shorter tests.

    Example: Separate "login" and "checkout" into two tests.
  </Accordion>

  <Accordion title="GitHub bot not commenting">
    **Fix:** Verify GitHub App has "Pull requests: Read & Write" permissions.

    Reinstall app if needed: github.com/apps/rehearsal-ai
  </Accordion>

  <Accordion title="Test is flaky (passes sometimes, fails others)">
    **Fix:** Add explicit waits. In test description: "Wait for spinner to disappear, then click Next".

    Rehearsal auto-adds waits, but complex apps need hints.
  </Accordion>

  <Accordion title="Can I test localhost apps?">
    **Yes.** Use ngrok or similar tunnel. Point test to public URL.

    Or contact us about self-hosted runners: [support@rehearsal.ai](mailto:support@rehearsal.ai)
  </Accordion>

  <Accordion title="How do I handle authentication?">
    **Two options:**

    1. Include login in each test description
    2. Use test setup with saved cookies (contact support for this feature)
  </Accordion>
</AccordionGroup>

## Pricing & Limits

**Free tier:**

* 10 tests/month
* 50 test runs/month
* Community support

**Pro (\$49/mo):**

* Unlimited tests
* Unlimited runs
* Priority support
* Custom test suites

**Enterprise:**

* Self-hosted runners
* SSO/SAML
* SLA guarantees
* Dedicated support

## Getting Help

* **Email:** [support@rehearsal.ai](mailto:support@rehearsal.ai)
* **Discord:** [discord.gg/rehearsal](https://discord.gg/rehearsal)
* **Docs:** [https://docs.rehearsal.ai](https://docs.rehearsal.ai)

<Note>
  Response time: \< 2 hours for Pro/Enterprise, \< 24 hours for Free tier.
</Note>