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

# Documents

> Write, edit and organize what your agent knows

## The Documents list

**Context > Documents** lists every document your agent can draw on: text you wrote, uploaded files, crawled website pages and Q\&A pairs. Use the search box, the type filter (All / Text / Files / Website / Q\&A) and the channel filter to find things. Click any column header to sort.

Each row shows:

* The title (and URL or file name), with a **Pinned** badge when it is always included
* One column per channel. A filled dot means the document is used there. **Click a dot to toggle** that channel without opening the document.
* Size, status (Ready / Processing / Error / Disabled) and when it was last updated
* A menu with Edit, Enable/Disable, Always include / Unpin, Re-index and Delete

## Writing a document

<Steps>
  <Step title="Add > Write text">
    Give it a clear title, for example "What is Acme", "Refund policy", "Sales playbook".
  </Step>

  <Step title="Add the content">
    Plain text or markdown. Write the way you would explain it to a new hire. There is no hard size limit, but a document over a few thousand characters should probably not be pinned.
  </Step>

  <Step title="Choose channels">
    Check the channels this document applies to. Voice shows a reminder that voice documents are sent in full at call start.
  </Step>

  <Step title="Pinned or retrieved">
    Turn on **Always include** for the essentials (who you are, core rules). Leave it off for reference material; the agent pulls that in only when a question calls for it.
  </Step>

  <Step title="Create">
    The document is indexed in a few seconds and shows **Ready**.
  </Step>
</Steps>

## Create from website

If a website is connected, **Add > Create from website** reads all crawled pages and writes a new pinned *About \<company>* document with the essentials (services, contact info, hours). Review and edit it afterwards; it is a starting point, not a final answer.

## Editing and managing

* **Edit** any document, including website pages and file text, by clicking its row.
* **Disable** to stop the agent using it without deleting it.
* **Delete** removes it immediately. Website pages come back on the next crawl if the page still exists.
* **Re-index** rebuilds the search index for a document (or re-scrapes a website page). Use it if a document shows **Error**.

## Status meanings

| Status       | Meaning                                                                                 |
| ------------ | --------------------------------------------------------------------------------------- |
| Ready        | Indexed and in use on its channels                                                      |
| Processing   | Being converted or indexed; usually a few seconds                                       |
| Error        | Something failed (hover for details). Re-index, or edit and save.                       |
| Disabled     | Kept but not used                                                                       |
| Needs answer | A Q\&A captured from a conversation, waiting for you (see [Q\&A](/features/context/qa)) |