Skip to main content
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: 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

1

Open the target index

Navigate to the index where you want to add documents.
2

Upload files

Drag and drop files or use the upload button. You can upload multiple files at once.
3

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)
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.
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.

​
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, 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
Document deletion is permanent. Make sure you have the original file elsewhere before removing it from Circuit.

​
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.