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

# Training Status

> Track when your sources finish training, retry failures, and read the training-complete email.

Every source you add is queued and read by a background worker before your bot
can use it. The training status tells you where each source is. You'll find it
next to each source on the **Sources** tab.

## What each status means

| Status       | Meaning                                           |
| ------------ | ------------------------------------------------- |
| **Trained**  | Done – your bot can answer from this source now.  |
| **Training** | In progress – Chatref is reading the content.     |
| **Pending**  | Waiting in the queue to be read.                  |
| **Failed**   | Something went wrong – the source wasn't learned. |

## Retry or remove a source

Each source has its own controls on the **Sources** tab:

* **Retry** a source that shows **Failed** to send it through training again.
  A retry helps when the failure was temporary – say, your site was briefly down
  during a crawl.
* **Delete** any source you no longer want. You'll be asked to confirm first.

<Tip>
  If a source keeps failing, the content may not be readable as-is. For a scanned
  PDF, retype the key parts as a [Text source](/knowledge-base/training-with-text)
  instead.
</Tip>

## The live training banner

Open the [Playground](/agents/playground) while sources are training and you'll
see a live banner at the top. It updates on its own – amber while training is in
progress, green when it finishes, and red if any source failed. The banner links
straight back to the **Sources** tab so you can check or retry.

## The training-complete email

You don't have to sit and watch. When a batch of sources finishes training,
Chatref sends you **one email** so you know it's ready. Add ten files at once and
you still get a single email – not ten.

The email comes in one of three flavors:

| Outcome        | What the email says                                                       |
| -------------- | ------------------------------------------------------------------------- |
| All trained    | Your bot is trained and ready – with a link to test it in the Playground. |
| Mostly trained | It's ready, but a few sources need attention so you can retry them.       |
| All failed     | It couldn't finish training – with a link back to your **Sources** tab.   |

<Note>
  A later batch sends its own email. So if you train your site today and upload a
  file next week, you get one email each time – one per batch that finishes.
</Note>

<Tip>
  Got the "a few sources need attention" email? Open the **Sources** tab and
  **Retry** the failed sources. Once they show **Trained**, your bot can answer
  from them too.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Test your bot" icon="robot" href="/agents/playground">
    Ask a question about your newly trained content in the Playground.
  </Card>

  <Card title="Add more sources" icon="globe" href="/knowledge-base/overview">
    Train with websites, files, or text from the Knowledge Base.
  </Card>
</CardGroup>