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

# Managing documents

> Upload, organize, and maintain documents within your indexes.

Documents are the foundation of your Circuit indexes. This page covers supported file types, the upload process, folder structure, and document lifecycle management.

## Supported file types

Circuit can process a wide range of document formats:

| Format               | Extensions                      | Notes                                                    |
| -------------------- | ------------------------------- | -------------------------------------------------------- |
| PDF                  | `.pdf`                          | Full text extraction including tables, images, and forms |
| Microsoft Word       | `.docx`                         | Paragraph-level processing with formatting preserved     |
| Microsoft PowerPoint | `.pptx`                         | Slide-by-slide processing with speaker notes             |
| Microsoft Excel      | `.xlsx`                         | Sheet-by-sheet processing with table structure preserved |
| CSV                  | `.csv`                          | Row-based processing for structured data                 |
| EPUB                 | `.epub`                         | Chapter-based processing for e-books and long documents  |
| HTML                 | `.html`                         | Web page content extraction                              |
| Markdown             | `.md`                           | Section-based processing                                 |
| Email                | `.msg`                          | Email body and metadata extraction                       |
| Images               | `.png`, `.jpg`, `.jpeg`         | Visual content extraction (OCR and image analysis)       |
| CAD                  | `.dwg`, `.dxf`, `.step`, `.stp` | Engineering drawing and 3D model extraction              |

Circuit continues to add support for additional formats. If you have documents in a format not listed here, try uploading them to see if they are supported.

## Uploading documents

<Steps>
  <Step title="Open the target index">
    Navigate to the index where you want to add documents.
  </Step>

  <Step title="Upload files">
    Drag and drop files or use the upload button. You can upload multiple files at once.
  </Step>

  <Step title="Monitor processing">
    Each document goes through Circuit's processing pipeline. Status indicators show:

    * **Processing**: the document is being analyzed and indexed
    * **Completed**: the document is fully indexed and searchable
    * **Failed**: processing encountered an error (check the document format and try again)
  </Step>
</Steps>

Processing time depends on document size and complexity. Most documents complete within seconds to a few minutes.

## Folder organization

Within an index, you can organize documents into folders to keep things manageable. Folders are organizational only and do not affect how agents search the content.

<Tip>
  Use folders to mirror how your team already structures its documents. For example: by product line, by document type (manuals, datasheets, procedures), or by date.
</Tip>

## Updating documents

When a document is updated externally:

1. Upload the new version to the same index
2. Circuit reprocesses the document, replacing the previous indexed content
3. Agents immediately start using the updated content

For documents synced through [feeds](/admin/integrations), updates happen automatically when the source changes.

## Removing documents

When you delete a document from an index:

* The document's indexed content is removed
* Agents can no longer find or cite that document
* Existing chat histories that referenced the document retain their citations, but the source is marked as unavailable

<Warning>
  Document deletion is permanent. Make sure you have the original file elsewhere before removing it from Circuit.
</Warning>

## Document best practices

* **Keep documents current**: outdated documents lead to outdated answers. Remove or replace documents when new versions are available.
* **Use descriptive file names**: agents can reference file names in citations, so "XYZ-500 Installation Guide Rev3.pdf" is more helpful than "doc\_final\_v2.pdf."
* **Upload documents as-is**: Circuit is designed to process large, complex documents. There is no need to break them up before uploading.
* **Check processing status**: if a document stays in "Processing" for an extended time or fails, try re-uploading it.