> For the complete documentation index, see [llms.txt](https://passion-io.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://passion-io.gitbook.io/help/when-something-goes-wrong/troubleshooting.md).

# Fix Common Issues With Your AI

Quick fixes for the problems creators hit most — a Resource that won't read, answers that miss, or clients who can't get in.

> **Your AI** is available on certain plans and app types. If you don't see the AI block in your sidebar, please check our pricing page for more information.

## In This Article

* [A Resource Won't Read](#a-resource-wont-read)
* [Your AI Gave a Wrong or Off-Topic Answer](#your-ai-gave-a-wrong-or-off-topic-answer)
* [Clients Can't Reach Your AI](#clients-cant-reach-your-ai)
* [A Client Can't See Your AI in Your Passion App](#a-client-cant-see-your-ai-in-your-passion-app)
* [You're Running Low on Credits](#youre-running-low-on-credits)

## A Resource Won't Read

When a Resource shows **Failed**, your AI couldn't read it, so nothing from that file reaches your answers.

1. Open the row's menu in **Resources** and select **Retry indexing**.
2. If it fails again, replace it with a simpler export — a PDF or Markdown file instead of a complex format.
3. Confirm the file isn't empty, password-protected, or a scan with no selectable text.

A Resource stuck on **Reading…** is still processing — larger files take longer. See [Add Resources to Your Library](/help/make-your-ai-answer-well/add-resources.md).

## Your AI Gave a Wrong or Off-Topic Answer

Answers come from your Resources and your instructions, so that's where the fix is.

1. Open the conversation in **Insights** (previously Conversations) and check the reply's citations. If it cited nothing or the wrong Source, add or fix a Resource and set its **Visibility** to **Cited** or **Private**.
2. If the tone or approach was off, add a line in **Behavior** under **Custom rules**.
3. If your AI answered something you don't cover, add a **Boundary** so they decline it next time.

See [Set Your AI's Primary Role](/help/make-your-ai-answer-well/set-primary-role.md) and [Add Resources to Your Library](/help/make-your-ai-answer-well/add-resources.md).

## Clients Can't Reach Your AI

1. Open **Publish** and confirm the status pill reads **Live**, not **Not yet live**.
2. If access is invite-only, confirm at least one access code exists — without one, no one can get in. Use **Manage invite codes**.
3. Share the exact `passion.io` link from the **Share publicly** section, and preview it in a new tab to confirm what clients see.

See [Share Your AI With a Public Link](/help/get-your-ai-in-front-of-clients/share-public-link.md).

## A Client Can't See Your AI in Your Passion App

1. In **Publish**, under **Inside your Passion app**, confirm your AI isn't turned off with **Hide from app**.
2. Under **Choose which of your plans include your AI**, confirm the client's plan is added — your AI only appears on the plans you've added.

See [Share Your AI With a Public Link](/help/get-your-ai-in-front-of-clients/share-public-link.md).

## You're Running Low on Credits

If your AI slows or stops answering, check your credits first.

1. Open **Subscription** and find the **Credits** card to see what you've used and when it resets.
2. Turn on **Extra credits auto-purchasing** so a busy week doesn't leave clients without answers.

See [Check Your Plan and Credits](/help/run-your-account/check-plan-and-credits.md).

For more assistance, please [contact us](https://passion.io/help).