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

# Uploading Files to the Knowledge Base

> How to Upload Files to the Knowledge Base

The Knowledge Base (KB) accepts a variety of file types and offers multiple upload methods to fit different workflows. Before uploading, review the size limits and supported formats below to ensure smooth processing.

## File Size Limit

Each file must be **200 MB or less**. If a file exceeds this limit, split it into smaller segments before uploading.

## Supported File Formats

<CardGroup cols={3}>
  <Card title="Documents" icon="file-lines">
    PDF, DOCX, TXT, MD, HTML
  </Card>

  <Card title="Data Files" icon="database">
    CSV, JSON, XML
  </Card>

  <Card title="Multimedia" icon="photo-film">
    MP3, MP4
  </Card>
</CardGroup>

## Upload Methods

When uploading, you can choose between two processing modes:

* **Regular Upload** — Files enter a processing queue and are handled in order. Best for bulk uploads, large files, or multiple files at once.
* **Quick Upload** — Files are processed immediately, bypassing the queue. Best for **single** small files that need to be available right away.

<Warning>Quick Upload only supports one file at a time.</Warning>

## Ways to Upload Files

Choose the method that best fits your workflow:

<Tabs>
  <Tab title="Drag and Drop">
    Drag files from your file explorer directly into the KB upload area.

    <Steps>
      <Step title="Drag Files">
        Drag one or more files from your file explorer into the KB upload area.
      </Step>

      <Step title="Verify and Upload">
        Verify the files you want to upload and click **Upload** when ready.
        <Info>For single-file uploads, you can optionally enable **Quick Upload** for immediate processing.</Info>

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/knowledge-base/kb-upload-single-file.png" alt="File Upload with Quick Upload Option" />
      </Step>

      <Step title="Processing">
        Your files will be processed and added to the Knowledge Base.
      </Step>
    </Steps>
  </Tab>

  <Tab title="File Upload">
    Browse and select files from your device using the file selector.

    <Steps>
      <Step title="Open File Selector">
        In the top-left corner, click **New** and select **File Upload** from the dropdown menu.
      </Step>

      <Step title="Choose Files">
        Browse your device and select the files you want to upload.
      </Step>

      <Step title="Verify and Upload">
        Review your selection and click **Upload** when ready.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/knowledge-base/kb-upload-multi-files.png" alt="Multiple Files Upload" />
      </Step>

      <Step title="Processing">
        Your files will be processed and added to the Knowledge Base.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Folder Upload">
    Upload an entire folder while preserving its internal structure.

    <Steps>
      <Step title="Open Folder Selector">
        In the top-left corner, click **New** and select **Folder Upload** from the dropdown menu.
      </Step>

      <Step title="Choose Folder">
        Browse your device and select the folder you want to upload. All files within it will be included.
      </Step>

      <Step title="Verify and Upload">
        Review the files to be uploaded and click **Upload** when ready.
      </Step>

      <Step title="Processing">
        Your files will be processed and added to the Knowledge Base, with their original folder structure preserved.
      </Step>
    </Steps>
  </Tab>

  <Tab title="URL Upload">
    Pull a file directly from the web into your Knowledge Base using a URL.

    <Steps>
      <Step title="Open URL Input">
        In the top-left corner, click **New** and select **URL Upload** from the dropdown menu.
      </Step>

      <Step title="Enter URL">
        Paste the URL of the file you want to import.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/odinai/img/knowledge-base/kb-upload-add-url.png" alt="URL Upload" />
      </Step>

      <Step title="Processing">
        Your file will be processed and added to the Knowledge Base.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web Crawling">
    Crawl and index content from an external website directly into your Knowledge Base.
    <Info>For full instructions, refer to the [Using Web Crawlers](knowledge-base/kb-crawler) page.</Info>
  </Tab>
</Tabs>

## Best Practices

<Steps>
  <Step title="Validate your files">
    Confirm files are properly formatted and not corrupted before uploading.
  </Step>

  <Step title="Use structured formats for large datasets">
    For data-heavy uploads, prefer CSV or JSON — they process more efficiently than unstructured text.
  </Step>

  <Step title="Clean up metadata">
    Remove unnecessary metadata or extra formatting that could interfere with AI processing.
  </Step>

  <Step title="Split oversized files">
    Any file exceeding 200 MB must be divided into smaller segments before uploading.
  </Step>
</Steps>